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CONFIGURATION 


This page provides brief step-by-step instructions for configuring a port for Monitoring or Simulation. 

1 . Power up the Chameleon. The main configuration menu should appear (see page 2). 

2. Move the arrow cursor to Mode of Operation and press FI Monitor or F2 Simulat. If you have the 256k 
Data Capture option, you will also have the F4 Fast Mo (fast monitoring) function key which enables 
you to monitor up to 256K bps. 

3. Move the arrow cursor to the Physical Interface parameter. Press the function key that corresponds to 
the type of interface you are going using to use. 

a. If you selected Primary (Primary Rate interface) or Basic (Basic Rate Interface) as your Physical 
Interface, press F7 Physic! to display the setup menu for the interface. 

b. Complete the physical interface setup menu and press Go to return to the main configuration 
menu (see pages 1 3 - 1 6 for details about these setup menus). 

4. Press F6 Setup to display the protocol setup menu. 

5. Use the function keys to select a protocol and values for the other displayed parameters. Press Go to 
return to the main configuration menu. 

6. If Monitoring is your Mode of Operation, move the arrow cursor to Monitoring Data Source. Press FI 
Line (monitor a live line) or F2 Disk (monitor data that has been stored to disk). 

7. If Monitoring is your Mode of Operation, move the arrow cursor to Capture Mode. Press FI Cycle 
(cyclic acquisition buffer usage) or F2 18uffr( stop acquisition when buffer becomes full). 

8. For Dual Port machines, follow the same steps described above to configure the second port. If you do 
not want to use the second port, select Off as its Mode of Operation. 

9. Press Go to display the Applications Selection Menu (see page 3 for detail of menu). 

10. To select an application/simulator, move the cursor arrow to the application name and press the 
function key that loads the application/simulator for the desired port (The arrow cursor indicates the 
active window. To change between the Monitor and Simulate windows press Shift 1 or Shift T.) 

If you are using the Primary Rate Interface, load tie PRIMARY application to monitor the PRI during 
runtime. If you are using the Basic Rate Interface, load the BASIC application to monitor the BRI during 
runtime. 

11. When you have selected all desired applications/simulators, press Goto start them. 

Page banners appear for each application (except Direct-to-Disk). Use the page keys shown on page 
4 to display one or more pages. 

A Simulator is indicated by a page banner named Simulate A or Simulate B. For all Simulators (except 
Sitrex), when you display the page, the Simulator prompt (!) appears, enabling you to enter commands 
and run programs immediately. To access the Simulator Parameter Set-up Menu, at the ! prompt enter 
the command: setup. Change the displayed parameters as needed, and then press Zto return to the ! 
prompt. 

In Sitrex you are taken directly to the Parameter set-up menu and not to the ! prompt Change the 
displayed parameters as needed and then press Zto access the Simulator. 

12. To stop one or more applications or Simulators, select the Configuration page, and: 

• Press F10 Exit to stop all applications, Simulators and the C Shell, OR 

» Move the arrow cursor to the application/simulator and press the Stop key (FI , F2, or F3) which 

stops the selected application on the desired port, OR 

« Press F7 Reset to restart all applications without stopping them 


- 1 - 



MAIN CONFIGURATION MENU 


DataJSource; 

Source of Data (Monitor 
mode only): 

Line *» Monitor a live line 
Disk «* Monitor data already 
stored to disk 


Cap ture Mode: 
Determines use of 
acquisition buffer: 

Cycle - buffer cycles and 
overwrites oldest data 
1 Buffr •* acquisition stops 
when buffer becomes full 



Tekelec CHAMELEON 20 . Vrx.x Copyright (c) 1 98x 


Press F6 to change the PROTOCOL setup 1 



Press GOjLo-Accapt 


Setup Mode 


Port A 


Mode of Operation 
Physical Interface 
Protocol 


Monltoring j PORT A*] Data Source 
Capture Mode 


Mode of Operation 



V.11 

Basic 

Primary 

V.35 

V.36 

Setup 

Physlcl 

Version 

Save 

Set TO 



F9 


F10 


Setup Mode: 

Determines mode of 
configuration: 

Menu « Manual Setup 
Files ** Load config.file 
Autoexec » Load DEFAULT 
config.file 

Mode of Operation: 
Monitor » Monitor mode 
Simulate - Simulate mode 
Fast Mo - 256k 
Monitoring option 
Off - Port is not used 

Physical Interface: 

Type of Interface: 

V-type, PRI, BRI 

RtPlocpj; 

Displays protocol menu 

■ S stT.Qi 

Sets the value of the 
autoboot timer 


Displays valid values for 
selected parameter 


P hysi c); 


Version: 

Displays list of system 
files and numbers 


Save: 

Saves the displayed 
configuration to a named file 


Displays setup 
menu for PRI (page 14) 
or BRI (page 12) 
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APPLICATIONS SELECTION MENU 


Up/Dow n Arrow: 

indicates which arrow 
key to press to display 
additional applications 
In that window. 


Red arrow cursor 
indicates active window. 
White arrow cursor 
indicates inactive window. 
Press Shift f or Shift 4 to 
change active window 

load/Stop A: 


Loads/stops the selected 
application. 


-G~ 


Applications Selection Menu 


LEDS : PORT A 


Select Application and Port 


Acquisition Mode 

Running 


1 Monitoring 

Ports 

Monitoring 

Ports 

I DIRTDSK 
TRIGGER 
DUALLINE 


-#> ANALYSIS 
X25STAT 
BASIC 

A 

A 

Simulation 

Ports 

Simulation 

Ports 

*-► X25TEST 
FR HDLC 
SITREX 





n & 


FUNCTIONS 


Reset; 

Resets all applications, 
for example; 
clears History buffer. 

Resets ail statistics values to 0, 




Monitoring Window 

Displayed in Monitoring 
and Simulation modes. 


Simulation Window: 

Displayed in Simulation- 
mode only. 

Displays BASIC and C 
simulation programs 


Exit: 

Stops all applications and 
returns to the main 
configuraiton menu. 


SatT.O; 

Sets the value of the 
autoboot timer. 


Displays the main configuraiton 
menu without stopping applications. 


Save: 

Saves the displayed con- 
figuration to a named file. 
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PAGE MANIPULATION KEYS 


KEY 

FUNCTION 

Move T 

Moves the page banner upward one line at a time (increases the size of 
the page). 

Move 4 

Moves the page banner downward one line at a time (decreases the 
size of the page). 

Scroll T 

Scrolls the data displayed in the page upward one line at a time. 

Scroll 4 

Scrolls the data displayed in the page downward one line at a time. 

Shift Scroll T 

Scrolls the data displayed in the page upward the number of lines dis- 
played in the page. 

Shift Scroll 4 

Scrolls the data displayed in the page downward the number of lines 
displayed in the page. 

Shift Hide Page 

Hides the active page so that the banner is no longer visible on the 
screen (the application continues to run). 


Displays a page that has been hidden with Shift Hide Page. 

Replace 

Replaces the active page with one that has been hidden using Shift 
Hide Page. 

Shift Move f 

Displays the page in a special full-screen mode referred to as Blow 
Mode (indicated by the letter B on the top left side of the banner). Other 
pages cannot be accessed when the active page is in Blow Mode. 

Shift Move T again disables Blow Mode, and returns the screen to its 
previous state. 

Shift Move 4 

This option is available only on Chameleon 32s with PROM version 
1.16 or later. When the Chameleon Remote I/O port is contigured and 
connected to a remote device (async terminal or another Chameleon) 
this invokes the remote serialized mode, which transmits the active 
page to die remote device in serialized mode. This enables you to 
control the Chameleon from the remote device. See pagel 0 for a 
step-by-step procedure. 

























RLE FORMAT AND REQUIREMENTS 


Files 

The Chameleon files are compatible with MS-DOS 2.x and 3.x format. File names must adhere to these 
MS-DOS conventions: 

• File names are 1 - 8 characters in length 

• Optional 1 - 3 character file extension 

• Optional drive specification of A: (hard disk drive) or B: (floppy disk drive) 

• File name and file extension separated by a period (.) 

« Acceptable file name and path characters are: 

A-Z a-z 0-9 \ - _ 

Hard Disk Directories 

The Chameleon includes a 40 Mbyte hard disk which provides 1 0 Mbytes of storage for system software and 
user programs, and 30 Mbytes of storage for data capture. The hard disk has the directory structure shown on 
the following page. The root directory can contain a maximum of 1 40 files. The other directories can contain a 
maximum of 600 files. 

If the optional C Development System package is installed on your Chameleon 32, you will also have these 
directories: \BIN, \INCIUDE, \UB, and \USR. 


Floppy Disk Directories 

Generally, when you save traffic or copy files to a floppy disk, the file is copied into the root directory of the 
floppy disk (unless you copy an entire directory to a floppy disk). When accessing a floppy disk for an 
application, the Chameleon searches only the root directory. Therefore all user files should be in the root 
directory of a floppy disk. A maximum of 112 files are permitted in the root directory of a floppy disk. 


C Application Programs 

If the Chameleon 32 has the optional C package installed, you can run a C program compiled on the 
Chameleon 32 directly from the C shell. 

You can also start a C application program from the Applications Selection menu. To do this, copy the 
executable file (with the file name extension .exe) to one of the following directories: 

» A:\TEKELEC\ANALYSlS\xxxx (See page 6 for valid subdirectories of ANALYSIS) 

• A:\TEKELEC\SIMUL\xxxx (See page 6 for valid subdirectories of SIMUL) 

The directory detemines when the application will appear in the Applications Selection menu. For example, if 
copied to A:TEKELEC\ANALYSIS\APPL, the application will appear in the Monitoring window of the 
Applications Selection menu for ail protocols. If copied to A:TEKELEC\ANALYSIS\X25, the application wiil 
appear in the Monitoring window of the Applications Selection menu only when X.25 is selected as the 
protocol, if copied to A:TEKELEC\SIMUL, the application wiil appear in the Simulation window of the 
Applications Selection menu for all protocols. The program can then be loaded and run as described on page 
1 . 



! D2D 


HIST j 

MENU | 

UTILITY 


TRIGGER 

Direct-to-DisI' 

Files 


History Files 


Menu 

Config Files 

Utility 

Config Files 


Triggering 

Files 


APPL | (Non-protocol specific Analysis files) 

ASYNC 1 ^ 

BISYNC 1 
DPNSS j 

ISDN j 
poH I 

— 1 Protocol-specific Analysis Files 

qllc 1 > ( F!,es are usecj based on the protocol 

1 f selection in the main configuration 

SNA | menu.) 

SS7 1 

X25 j 

X75 | 

DDCMP I J 


BISYNC 
BSC Files 

FDMI 

FRAMEM 
DM! Files 

SHDLC 
SIMP\L 
HDLC Files 

SLAPD 

SIMP\L 
LAPD Files 


SIMP\L 
V.120 Files 

I CUSR 


FRAMEM 
LAPD Files 


SSDLC 

SiMP\L 
SDLC Files 
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RLE MANAGEMENT MENU 


The Fiie Management page can be invoked at any time by pressing the Files key. The File Management Menu 
contains the following options: 


FI 

Chdir 

Changes the current disk directory. 

F2 

Copy 

Copies selected files to the hard disk or a floppy disk. 

F3 

Delete 

Deletes files from the the hard disk or a floppy disk. 

F4 

Rename 

Renames the selected files. 

F5 

Format 

Formats floppy diskette. 

F6 

Disk Copy 

Copies the entire contents of a floppy disk to another floppy disk. 

F7 

Transmit File 

Transmits files to a host computer (see page 12 for more 
information). 

F8 

Receive File 

Receives files from a host computer (see page 12 for more 
information). 

F9 

Connect 

Establishes a connection between the Chameleon and a host 
computer for file transfer or host terminal emulation. See page 1 1 
for more information. 


Directory Format 

There are two directory display formats. The default format displays files in four columns and shows the file 
name only. This format lists 60 files per screen. There is also a detailed directory format, which displays the 
time, date, and size of the fiie. The detailed format displays 15 flies per screen in a single column. 

To toggle between the two display formats, press Ctrl D. 

If the directory is longer than one screen display, the page number appears in the upper right comer. To move 
to the previous or next screen, press Shift t or Shift I, respectively. 

UstJSeJector 

The List Selector enables you to select several fiies or sub-directories for a single file management operation . 
To use the List Selector, do the following: 

1 . When the disk directory is displayed, move the arrow cursor to the first fiie or directory you want to 
select. 

2. Press the space bar to highlight the file or directory name. (To unselect a file, press the space bar a 
second time.) 

3. Continue this procedure to highlight all desired files. 

4. Select the fiie management operation. For example, press F2 Copy to copy the selected files. 

View ASCII Filets) 

After opening a directory to the file level, you can view the text of one or more of the files. This is possible only 
for ASCII files, not for directories or binary files. 

To view ASCII files: 

1 . Move the cursor to the desired fiie. 

2. Press the spacebar to highlight it. 

3. Repeat steps 1 and 2 for any additional fiies. 

4. Press Ctrl V. The selected file(s) are opened. F-keys 1 through 5 take on special functions: 

Fi MORE Scrolls down 1 page of current file. 

F2 NEXT Returns to files list or to start of next file 

F3 PREV Jumps to start of previous file, or current one if only one fiie open. 

F4 RESTART Jumps to start of current file. 

F5 QUIT Quits to directory. 



UTILITIES MENU 


The Utilities page can be invoked an any time by pressing Shift Utilities. The File Utilities Menu contains the 
following options: 


FI 

Remote I/O Port Setup 

Configures the Remote I/O port so that an Async terminal can be 
used to control the Chameleon remotely. 

F2 

Printer Setup 

Configures a printer port to output to a serial or parallel printer. See 
page 9 for a list of print commands and keys. 

F3 

Set Date and Time 

Sets the system time and date. 

F4 

Traffic Load/Save 

Saves Direct-To-Disk or Acquisition buffer traffic to a file. Loads a 
traffic file for Monitoring. 

F5 

645/705 Data Conversion 

Converts data acquired over a V-type interface by HARD 
Engineering Models 645 and 705 to a format compatible with the 
Chameleon 32.. 

F6 

Check Free Disk Space 

Displays the number of bytes available on the hard disk or a floppy 
disk. 

F7 

Kermit/Connect Mode Setup 

Configures the Aux Serial Port 2 for Kermit File T ransfer. See pages 
12 for more information. 

F8 

Backup/Restore Menu 

Backs up the entire hard disk or files that are larger than one floppy 
(700 Kbytes). 

F9 

FMS File Conversion 

Converts files created with the Chameleon 32 FMS operating 
system (software release 2.6.1 or earlier) to the Chameleon 
MS-DOS operating system format (Release 3.0 and later). 



PRINT KEYS AND COMMANDS 


APPLICATION 

KEY/COMMAND 

RESULT 

All applications 

Print Scm key 

Prints the current screen 


Print Page key 

Prints the active page 

History 

CtriP 

Displays print menu to print a user-defined 
range of events. See page 16 for a complete 
description. 

X.25 Statistics 

F3 Print key 

Prints an X.25 statistical report 

SNA Statistics 

F3 Print key 

Prints an SNA statistical report 

BSC Statistics 

F2 Print key 

Prints a BSC statistical report 

ISON Statistics 

F5 Print key 

Prints an ISDN statistical report 

SS#7 Statistics 

FI Print key 

Prints an ISDN statistical report 

BASIC Simulators 

LF1LES command 

Prints file directory 


IF LIST command 

Prints current function key assignments 


LUST command 

Prints the program in memory 


LML1ST command 

Prints the mnemonic table in memory 


LPRINT command 

Prints text 

- 

LTPRINT command 

Prints the contents of the trace buffer 

SITREX 

LDISPT command 

Prints timer values in decimal 


LDiSPC command 

Prints counters in hex 


LDISPV command 

Prints variable values 


LDSSPX command 

Prints numeric variables in hex 


LDiSPM command 

Prints length and contents of message buffer 


LUST command 

Prints the scenario in memory 


LPRINT command 

Prints text 

C Shell 

>.PRT 

Redirects output to the printer 


Aux Serial Port 2 
Library Functions 

See page 58 for a description of the functions. 

Triggering 

ACTION® STATS 
PRINT 

Prints the Statistics report when the triggering 
condition is met 
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REMOTELY CONTROLLING THE CHAMELEON 


Setting up your Chameleon to be controlled from a remote device entails two basic 
procedures: configuring the Chameleon as the slave (remotely-controlled) device, and 
configuring another device as the master. This master controller may be another 
Chameleon or other terminal device, such as a PC. The remote mode supports the 
Chameleon multiple page capability. To maximize the performance of the Chameleon, 
always disconnect a remote terminal when not in use. 

To set up your Chameleon as a slave device: 

1 . Using an RS-232 cable, connect the Chameleon to the master device: 

• If a terminal (async or PC terminal emulation) is the master device, connect the cable to the 
Chameleon Remote I/O port 

• If another Chameleon is the master device, connect a null-modem cable to the Aux 2 port on 
the master Chameleon, and to the Remote I/O port on the slave Chameleon 

2. At the slave Chameleon, open the Utilities menu and select FI Remote I/O Port Setup. 

3. Configure the slave Chameleon to transmit by selecting the parameter values (terminal type, baud 
rate, data bits, etc) required by the remote device. 

4. Press Goto accept the parameter values and to start remote mode. The Chameleon can then be 
accessed using the keys shown in the table on the next page. 

To set up your Chameleon as a master device: 

1 . Open the Utilities menu and configure the KERMIT/Connect mode (FT) to match the siave (remote) 
device. 

2. Press Go and exit from the Utilities menu. 

3. Open the File Management menu and press F9-Connect. 

4. Press TAB, TAB to re-fresh the screen and display data as displayed by the slave device. 

To disable the remote control of your master, press Shift Cancel . 

Once in remote mode, an alternate, serialized, remote mode can be activated. This causes 
the remote terminal screen to be updated constantly. However, only the active page is 
displayed by the remote terminal. 

To activate/deactivate serialized remote mode: 

1 , At the master device, press Shift Move 

2. At the slave device, press Tab Shift F 

The letter R in the banner of the active page on the slave device indicates that you are 
functioning in the serialized remote mode. 
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To emulate the 
Chameleon key: 

On the host, 
use: 

Hex 

Code 

To emulate the 
Chameleon key 

On the host, 
use: 

Hex 

Code 

FI 

Tab 1 

09 81 

Scroll ? 

Tab g 

09 67 

F2 

Tab 2 

09 82 

Move i 

Tabf 

09 66 

F3 

- Tab 3 

09 83 

Scroll i 

Tab h 

09 68 

F4 

Tab 4 

09 84 

Left Arrow 

Ctrl H 

08 

F5 

Tab 5 

09 85 

Down Arrow 

Ctrl J 

0A 

F6 

Tab 6 

09 86 

Right Arrow 

Ctrl L 

oc 

F7 

Tab 7 

09 87 

Up Arrow 

Ctrl K 

0B 

F8 

Tab 8 

09 88 

Replace 

Tab D 

09 44 

F9 

Tab 9 

09 89 

Select 

Tab d 

09 64 

F10 

Tab Ctrl J 

09 8A 

Ries 

Tabb 

09 42 

Cancel 

CtrIX 

18 

Utilities 

Tab B 

09 62 

Go 

Ctrl Y 

19 

Run/Stop 

TabO 

09 80 

Move T 

Tabe 

09 65 

Space bar 

Space bar 

20 

Print Page 

Tab A 

09 41 

ESCape 

ESCape 

IB 

Print Scm 

Tab a 

09 61 

Return 

Return 

0D 

Hide Page 

TabC 

09 43 

Help 

Ctrl W 

17 

Show Page 

Tab c 

09 63 

Delete 

Delete 

7F 

Shift? 

Tab Ctrl L 

09 0C 

Shift i 

Tab Ctrl N 

09 0E 


* If no page banner is displayed, the subject page cannot be printed out. 
Chameleon Keyboard Hex Values 


TERMINAL EMULATION 

This procedure describes how to use the Chameleon to emulate a host terminal. 

1 . Connect the host to the Chameleon Aux Serial Port 2 using an RS232 cable. (The Chameleon will 
act as the OCE. For this reason, you may require a special RS232 cable configuration. Refer to 
page 1 1 2 for details. ) 

2. Use the Kermit/Connect Mode Setup in the Utilities menu to configure the Chameleon to be 
compatible with the host 

3. When the configuration parameters are set, press Go to accept the values. 

4. On the Chameleon, invoke the Fiie Management menu and make it active. 

5. Press F9 Connect. This causes the Chameleon screen to go blank and behave as a host terminal. 

You can now enter host commands. To transfer files between the Chameleon and the host, refer to 
page 12. 

6. To exit the Connect window, press Shift Cancel. 
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KERMIT FILE TRANSFER 

To use the Kermit file transfer facility: 

1 . Verify that the host has a file transfer utility that is compatible with the KERMIT protocol. 

2. Connect the host to the Chameleon Aux 2 port using an RS232 cable, (pie Chameleon will act as 
the DCE. For this reason, you may require a special RS232 cable configuration. See page 82.) 

3. Using the Kermit/Connect Mode Setup in the Utilities menu, configure the Chameleon for file 
transfer. 

Note: Kermit automatically uses 8 data bits, 1 Stop bit and no parity, regardless of how you configure them 
in the Kermit/Connect Mode Setup menu. If you configure the Chameleon for terminal emulation, 
disregard these parameters in the Kermit/Connect Mode Setup menu. However, you must select 
the type of file you are going to transfer: Text or Binary. You cannot transmit binary and text files at 
the same time. 

4. Call up the host Kermit program. A prompt indicates that the file transfer program has been loaded 
and KERMIT commands that will be executed. (When entering host commands, you can enter the 
commands on a host terminal OR you can use the Chameleon Connect window to emulate a host 
terminal. See page 11.) 

5. On the Chameleon, open and activate the File Management menu. 

6. - Follow the appropriate instructions in the table below depending on whether you are transmitting or 

receiving files. As the file is transferred, information is displayed in the Transmit/Receive page so 
that you can monitor the progress of the transmission. When the transfer is complete, the screen 
displays the message Reception OK. 

• If the transfer fails, retransmit the fiie(s) by pressing FI Retry. 

• If an error was detected during the file transfer, the following message appears Send failed. 


IF THE CHAMELEON IS TRANSMITTING FILES: 

IF THE CHAMELEON IS RECEIVING FILES: 

a If necessary, use FI Chdir in the Chameleon 
Hie Management menu to select the drive and 
directory that contains the files you want to 
transmit to the host 

a. Enter the host command that transmits the fiies. 
For example: send filename.ext <RETURN> 

[You can use the asterisk (*) as a wildcard to 
select more than one file to transmit. 

For example, to transmit all files from the host 
with the extension .doc, enter: send '.doc] 

b. Use the List Selector to select the fiies you want 
to transmit 

(To use the List Selector, use the arrows keys to 
move the red arrow cursor to the desired file, and 
then press the space bar to highlight the file in 
red. Press the space bar a second time to 
unselect the file.) 

b. Make the Hie Management page active. 

c. Enter the following command on the host 
computer: receive <RETURN> 

c. Press F8 RX File. This begins reception. 

d. In the Chameleon 32 File Management menu, 
press F7 TX File. This begins the transmission. 



7. When file transfer is complete, press F10 Exit to return to the File Management menu. 

To abort the operation in the middle of a transfer: 

Press Esc. The message Send failed is displayed. 
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Basic Rate Interface Setup Menu 



Mode Selects the mode to use for layer 1 . 

Simulate Simulates layer 1 as an NT or as a TE. (default) 

Monitor Monitors layer 1 . 

Channel 

Selection Selects the channel to be used for running the upper level (above layer 1 ) protocol software. 

The options are: B1, 82, or D (default). 

Device Selects the type of device to be simulated (Simulation mode only). 

NT Network Termination (default) 

TE Terminal Endpoint 

Channel 82 

Channel B1 Selects an option for the 81 or 82 channel. 

Milliwatt Inserts a digital milliwatt tone (OdBm, 1 004 Hz ?~law or 1 020 Hz A-law) in the 
selected 8-channel. (Simulation mode only.) 

Codec Allows a handset using Codec to be connected to the Chameleon Basic Rate 
Interface. 

Idle Idles the channel with all ones data (default) 

Ext B Selected B channel available at the Ext B interface (RS422 compatible) of the 

Chameleon Basic Rate Interface. 
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Basic Rate Interface Setup Menu (continued) 

Layer 1 Selects an option for layer 1 activation. 

Interactive At runtime, interactive transmission of signals is possible. (No automatic 
activation is done.) (default) 

Automatic Whenever Layer 1 is deactivated, or goes to error state, the system 
automatically activates. 

Note The following three parameters are supported only on machines with Basic Rate Interface Board 
(805-0259), Revision F, 

Bit 

Inversion Inverts the data bits when a B channel is selected for the Channel Selection parameter. 
NT Power Specifies the type of power provided from the NT to the TE. 

SRCINor Power source t under normal conditions. 

SRCIRev Power source 1 under emergency conditions (reverses polarity). 

SRC2Nor Power source 2 under normal conditions. 

SRG2Rev Power source 2,under emergency conditions (reverses polarity). 

Off The NT power lines are turned off. 

DTMF 

Number This parameter is relevant when the Codec unit is selected for a B-channel. It causes the 

Chameleon to generate the Dual Tone Multi-Frequency (DTMF) tones corresponding to the 
numbers entered in this field. You can enter a maximum of 20 digits in the DTMF Number 
field. Only digits are allowed. 
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Primary Rate interface Setup Menu 



Mode Selects the mode to use. 

Simulate Generates data from the Chameleon, and sends it on the line. If you selected Monitor for 
Mode of Operation, the Chameleon simulates the physical layer, while monitoring layers 
2 and above. 

Monitor The Chameleon monitors the line only. 

Framing Selects the type of framing to be used. 

D4 D4 Framing. This is available only for the ANSI PRI. 

ESF Extended Super-Frame. Available only for ANSI PR!. 

SL96 Selects StC-96 framing. Available only for ANSI PRI. 

CEPT CEPT recommended framing. Available only for CEPT PRI. 

Signal 

Coding Selects the Zero Suppression scheme. 

ANSI options: B8ZS Bipolar 8 Zero Suppression 

AJW/Aitemate Mark Inversion, without zero suppression 

CEPT options: HDB3 High Density Bipolar 3 with zero suppression 

AJW/Altemafe Mark Inversion, without zero suppression 

Signaling For ANSI, enables/disables signaling information for Lines 1 and2. ForCEPT, enables signaling 

information in time slot 16. When Signaling is On, the Idle Signal parameter determines the idle 
pattern to be used. 
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Primary Rate Interface Setup Menu (continued) 

Transmit 

Mode 


Resync 

idle 


Transparency 


Re-synchronizes the line. 

Transmits an Idle Sequence on the line. Specify the idle sequence using the idle 
Channel parameter. If BERT error insertion rate is set to 1 .OE-3 or greater, you 
will encounter a frequent loss of synch and the BERT error statistic will be thrown 
off by the on/off loss of synch. 

Available for Line 1 only. The Chameleon synchronizes the Tx clock to the Rx 
clock and transmits its own data unless the application is configured to transmit 
the received data 


Remote Alarm 
Yellow Alarm 
Repeater 
Data Rate 
CRC 

Idle Channel 


Transmits the Remote Alarm signal. (CEPT only) 

Transmits the Yellow Alarm signal. (ANSI only) 

The Tx clock is synchronized to She Rx dock and received data is re-transmitted. 
Sets Data X and Data Y for either 56K or 64K (ANSI only). 

Enables/disables a Cyclic Redundancy Check in the signals (CEPT only). 


Specifies the idle sequence to send on channels for which no other function is selected. 
Enter an 8-bit sequence (LS8 — -> MSB). 

Idle Signal When Signaling is enabled (ON), this specifies the sequence of bits to send on the 

signaling channel, when idle. For D4 and ESF framing, enter a two- bit pattern. For ESF, 
the two bits are repeated in the four bit signal. For CEPT framing, enter a four bit pattern. 


The remaining parameters allow you to make selections for a specific channel/time slot. A 
value of 00 de-selects the current selection. For ANSI, these parameters accept a value for the 
channel number (1-24). For CEPT, these parameters accept a value for the time slot (1 - 31 ). 


Receive Data X Selects the receive channel/time slot for Simulation or Monitoring packages. Datacanbe 

received on either Line 1 or Line 2, but not on both simultaneously. 

Receive Codec Selects the channel/time slot to enable the Codec Receiver (Line 1 only). 

Receive Data Y Selects the channel/time slot to enable the Data Y Receiver (Monitor Mode only, Line 1 
only). 

Transmit Data Y Simulate Mode of Operation only. Selects the channel/time slot to be used with the DSG Y 
Receiver in Monitor Mode. In Simulation Mode, this parameter takes the channel/time 
slot for the Line 1 Transmitter. 

Transmit Codec Simulate mode only. Selects the channel/time slot for the Codec Transmitter. 

Transmit Milliwatt Simulate mode only. Selects the channel/time slot to enable the Digital Milliwatt Tone 
Generator. The tone generated in ANSI (D4/ESF) is 1 004 Hz at 0 dBm. In CEPT, the tone 
can be either 820Hz or 1020Hz. 


Milliwatt Tone Simulate mode only. Selects the Milliwatt Tone for CEPT. 

DS0 Inversion Inverts the data on the specified channels/time slots in Data X and Data Y. 
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2B1Q U-1NTERFACE SETUP MENU 



Device: 

Clock: 

Port A: 

Port B: 

Analog Interface: 

Channel Selection: 
Encoding: 

Idle Pattern Destination: 
Bit pattern: 


Configuration 

2B1Q Setup Menu 



Ext/Int/NT Recovered 
B1/B 2/D/OFF 
B1/B2/D/OFF 
Handset/600-Ohm/OFF 
B1/B2 

A-Law/u-Law 

B1/B2/D/OFF 

nnnnnnnn 


NT 

LT 








EXIT 

FI 

F2 

F3 

F4 

F5 

F6 

F7 

F8 

F9 

F10 


Device Sets your Chameleon to emulate a network (LT) or network node/temninal device (NT). This 

setting cannot be changed in the Run Time configuration menu. 

Clock Sets your Chameleon to take its timing from an external timing source, the Chameleon 

8-MHz dock (internal), or to derive docking from the bit-stream being sent over the 
U-interface. This setting cannot be changed in the Run Time configuration menu. 

Port A Sets Port A of your Chameleon to function as either a B1-, B2-, or D-channel port. Also 

deactivates Port A altogether (OFF). The channel you assign here canot also be assigned to 
Port B and/or the Anaiog Interface. 

Port B Same as for Port A. The channel you assign here cannot also be assigned to Port A and/or 

the Analog Interface. 

Analog Interface Sets the physicai/electrical mode of the analog interface. 

Channel Selection Assigns the channel for which the anaiog device is to be the interface. 

The channel you assign here cannot also be assigned to Port B and/or 
Port A 

Encoding Sets the anaiog interface to be encoded in either A-Law or u-Law. 

Idle Pattern Destination Assigns the channel to which the idle pattern is to be transmitted. Also 

de-activates idle pattern transmission altogether. 

Bit Pattern Enter the bit pattern you want to use as the idle Pattern. This will then be transmitted to the 

destination channel selected above. 
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2B1Q SIMULATION CONFIGURATION 


Q- 


2B 1 Q Sfmu lation 


CONFIGURATION 

>'Atf//////A 

LT 

EXIT 


FUNCTION MESSAGE SEND 


Eoc Control: 

Every •*— 

M4 Control: 

Verified Dual 

M5 Control: 

Dual 


Message 

Activation Status: 

Link Status: 

Superframe Sync, Status: 
Error Indicator: 


{as selected in MESSAGES menu) TX: nn(hex) 

FEBE Count: 
NEBE Count: 
Simulations: 
XCVR Mode: 


NT 


LT 


EXIT 


Ft 


F2 


F3 


F4 


FS 


F6 


F7 


F8 


F9 


F10 


The 1 0 link status messages at the bottom of this screen are read-only. For detailed explanations, see your 
Protocol Interpretation Manual, page 20-18. 

Configuration: 

Select the network entity you want your Chameleon to emulate: 

NT = terminal device in a network. 

LT a network. 

Or, select EXIT to back out of the 2B1 Q simulation application to the Applications Selections Menu. 

After selecting either NT or LT and pressing RETURN, the applicable sub-menu appears. 

Select EOC Control, M4 Control, or M5 Control. 

Use the Space Bar to toggle to the Control option you want 
For EOC, the options are: 

Every 

Trinai-Check, and 

{for the NT configuration only) Auto EOC Processor. 

For M4, the options are: 

Verified Dual Consecutive 
Dual Consecutive 
Delta 
Every 

For M45/M6, the options are: 

Dual Consecutive 

Delta 

Every 


— 1 8 ” 











2B1Q SIMULATION CONFIGURATION (continued) 


Press GO to close the sub-menu and return to the Configuration menu. 

Press the right arrow to select the FUNCTION menu. 

Function: 

Select the desired function for the U transceiver of your Chameleon: 

Activate » Local U transceiver will initiate start-up, notify remote U transceiver that it is 

ready to communicate over Layer 2. 

Deactivate = Turns the local U transceiver off. 

28 + D Loopback = Sets the local U transceiver to loop B1 , B2 and D channels back to remote U 

transceiver. 

B1 Loopback = Sets local U transceiver to loop B1 channel only back to remote U 

transceiver. 

B2 Loopback = Sets local U transceiver to loop B2 channel only back to remote U 
transceiver. 

Corrupt CRC * Sets local U transceiver to generate a corrupted CRC. 

Return to Normal = Resets local EOC processor to initial state: terminates ail outstanding 

EOC-controlled operations. 

Reset XCVR = Resets local U transceiver chip. AFTER SELECTING AND EXECUTING 

THIS OPTION, YOU MUST RESET ALL CONTROL MODES IN THE 
CONFIGURATION SUB-MENUS. 

Clr Err Counters = Sets to zero the local U transceiver FEBE and NEBE error counters. 


Press GO to close the menu. 

Press the right arrow to select the MESSAGE menu. 

Message: 

Select the EOC, M4 or M5/M6 message you wait to build. The options available for each type of message 
depend upon the configuration you selected - NT or LT. Have you forgotten your Configuration 
selection? Look at the Simulation line in the Status Window. It will show the configuration you selected 
earlier in this procedure. For explanations of the options listed below, see your Protocol Interpretation 
Manual, page 20-32. 

NT LT 


EOC 

Unable to Comply 
Hold State 


M4 message 
ACT (activate) 

PS1 (Power Supply, bit 1) 
PS2 (Power Supply, bit 2) 
NTM (NT Test Mode) 

CSO (Cold Start Only) 
Reserved 6 

SAI (S/T Interface Activity) 
Reserved 8 
M5/6 message 
Reserved 51 
Reserved 61 


EOC 

Operate 2B + D Loopback 
Operate B1 Loopback 
Operate B2 Loopback 
Request corrupted CRC 
Notify of corrupted CRC 
Return to Normal 
Hold State 

M4 message 
ACT 

DEA (deactivate) 

Reserved 3 
Reserved 4 
Reserved 5 
Reserved 6 

UOA (U-Interface Only Activation) 
AIB (Alarm Indication Bit) 

M5/6 message 
Reserved 51 
Reserved 61 
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2B1Q SIMULATION CONFIGURATION (continued) 


Reserved 52 Reserved 52 

FEBE FEBE 


Send 

it is from this menu that you transmit the message built in the preceding Message menu. You can send this 
message only once each time. To send the same message repeatedly, press Return for each 
transmission. 
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ANALYSIS CONTROL/SHIFT KEYS 


These Control and Shift keys provide special functions in the Analysis pages. 


KEY 

FUNCTION 

A or a 

For Dual Port machines, displays the Port A function key strip in History 

Borb 

For Dual Port machines, displays the Port B function key strip in History 

Ctrl B 

Switches on/off a fine which separates events in the display 

Ctrl C 

Toggles between the Port A and Port B function key strip display ( Dual Port only) 

Ctrl E 

Enabies/disables the display of the Incomplete event message. 

Ctrl N 

Relevant for ISDN monitoring only. Toggles the display between the extended 
address in hex and the LTID or TGI byte interpretation. 

CtrlP 

Activates History Print/Fiie feature. See description below. 

Ctrl Z 

Protocol specific to SS7. Invokes the User Parts Editor. 


HISTORY PRINT/FILE FEATURE 

Ctrl P invokes the History Print feature which outputs a range of events to a printer or ASCII file. Note that a 
file saved in this manner cannot be replayed in Analysis. There are two ways to use this feature: 

Method 1 - Enter a specified range of events: 

1 . Make the History page active. 

2. Press Ctrl P, You are prompted for a file name and a range of events. 

3. To output events to a printer, press Return when prompted for a file name. Your printer should already 
be connected and the Chameleon printer configuration set up. 

To output events to an ASCI I file, enter a file name and press Return. The file will be saved to the hard 
disk in the following directory: A:\TEKELEC\DATA\HIST. 

4. Enter the numbers of the first and last events you want to output 

5. Press Go to start the printer/file output. 

6. To abort this function at any time, press Cancel. 

Method 2: Highlight a range of. events; 

1 . Make the History page active. 

2. Use Scrollt orScrolli key to positionthefirsteventyou want to output at the top of the page. Press the 
left bracket key ( I ). This marks (highlights) the first event 

3. Use the Scroll^ or Scroll i key to display the last event you want to output at the bottom of the screen. 
Press the right bracket key ( ] ) to mark (highlight the last event). 

4. Press Ctrl P to invoke the History Print menu. 

5. To output events to a printer, press Return when prompted for a file name. 

To output events to an ASCII file, enter a file name and press Return. The file will be saved to the hard 
disk in the following directory: A:\TEKELEC\DATA\HIST. 

6. The selected event numbers are displayed in tie menu. You can change them by deleting the number 
and enter a new number. 

7. Press Go to start the printer/file output. A message is displayed that indicates which events are being 
sent to the printer or file. 

8. To abort this function at any time, press Cancel. 
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HISTORY DISPLAY KEYS 

The keys aid commands listed control the data that is displayed in the History page. If theselected event is not 
valid (for example, it was overwritten in the buffer), the first valid event following the selected event is 
displayed. 


KEY 

FUNCTION 

4— 

The left arrow displays the oldest events in the buffer. 


The right arrow displays the most recent events in the buffer. 

T 

The up arrow scrolls the data upward continuously. Each time you press the 
up arrow, the scrolling speed increases. If data is scrolling downward, it decreases 
the speed of the downward scroll. 

4 

The down arrow scrolls the data downward continuously. Each time you press the 
down arrow, the scrolling speed increases. If data is scrolling upward, it decreases 
the speed of the upward scroll. 

Space bar 

Stops scrolling. 

Scroll T 

The Scroll T key moves data up one line each time you press the key. 

Shift Scroll T 

Shift Scroll T displays the next page of data 

Scroll i 

The Scroll i key moves data down one line each time you press the key. 

Shift Scroll i 

Shift Scroll l displays the previous page of data. 

0-9 

The number keys move you to a certain point in the buffer. Each number 
represents a percentage of the buffer, from 0% (0) to 90% (9). For example, If you 
press 5, the middle (50%) of the buffer is displayed. 

Forf 

Freeze Mode - Displays the most recent 32K of data for display on the History page. 
While in Freeze Mode only 32K of data can be viewed on the page; however it will 
not be overwritten by new data being acquired. 

U or u 

Un-freeze - terminates Freeze Mode and returns you to the normal History display. 
When unfrozen the History page displays data from the acquisition buffer. 

:jump n 

Jumps to event number n. For example, :jump 1 50 displays event 150 as the first 
event on the page, .jump 99999 displays the end of the buffer (most recent events). 

mormai 

Used in conjunction with the Triggering application DISPLAY option. Selects normal 
triggering display mode which causes data which meets the triggering criteria to be 
shown in low intensity color. All other data is shown in high intensity color. 

itrigger 

Used in conjunction with the Triggering application DISPLAY option. Selects trigger 
display mode which causes only the data which meets the triggering criteria to be 
displayed in the History page. All other data is suppressed from the display. 
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DUAL LINE APPLICATION 


The Dual Line application displays data in a 2-line format (DCE over DTE) which represents the actual 
sequence of data as it was acquired by the Chameleon. This type of display enables you to determine the 
overlap of data being received simultaneously from both sides of the line. To start the application, select 
DUALLINE from the Monitoring window of the Applications Selection menu. F10 toggles between the two 
Dual Line modes: Run mode and Freeze mode. 

Run mode causes the page to be updated as data is acquired from the line or from disk. In Run mode the 
display shows the following information: 

• The DCE and DTE baud rates are displayed at the top of the screen. 

• DCE data is displayed in brown above the DTE data 

• DTE data is displayed in underlined cyan below the DCE data 

• Each line displays up to 64 characters 

• Interface lead states are displayed when F3 State is selected. 

• Data is displayed in the format set selected with FI. 

« Blank spaces between frames indicate idle time. F2 controls the display of idle time. 

The Run mode function keys are as follows: 

FI determines in what format the data is displayed: ASCII, EBCDIC, HEX, HEXS. If F7=HEXS, 

data is displayed in hex pairs, with pairs alternating in high and low intensity color. 

F2 determines how idle data bytes are displayed. Idle data is shown as blank spaces between 

frames. F2 determines how many idle data bytes are represented by each blank space. For 
example, if F2 = 10, each blank space represents to bytes of idle data 

F3 determines what data is displayed. The options are: 

Data Data is displayed, but interface lead states are not displayed. 

State Both data and interface lead states are displayed. 

F1Q toggles between Run mode and Freeze mode. 

Freeze mode freezes the Dual Line page so that it is no longer updated as data is acquired. In Freeze mode 
there are additional function keys which enable you to scroll through the data. The Freeze mode display is the 
same as the Run mode display, with the addition of these fields: 

• Binary value of the DCE and DTE byte at the location of the cursor 

« Hex value of the DCE and DTE byte at the location of the cursor 

• ASCII or EBCDIC value of selected byte (depending on current FI selection) 

• Time stamp indicating the time that the end of the event was acquired. The time stamp is in the 
format: hh:mm:ss ddd ddd (ddd ddd is the number of microseconds in decimal) 

The Freeze mode function keys are the same as Run mode, with the addition of these function keys: 

F7 displays the previous page of data. 

F8 displays tine next page of data 

F9 marks the byte at the cursor as the base line byte. When a byte is marked, the 

. following changes occur to the Dual Line page: 

• The marked byte is shown in red 

« The dtime field displays the delta time between the marked byte and the byte at the cursor 

® The bytes field displays the offset between the marked byte and the byte at the cursor 
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BERT APPLICATION 


The Chameleon BERT application provides synchronous or asynchronous Bit-Error Rate Testing (BERT) 
data testing for a variety of data communications systems. The Chameleon can be configured to emulate 
either a DTE or a DCE over any of the Chameleon I/O modules. 

When BERT is started, the BERT Setup menu appears with the following configurable parameters: 

Framing selects Synchronous or Asynchronous timing. 

Interface specifies whether the Chameleon will simulate a DCE or a DTE device. 

Data Bits specifies the number of data bits in each byte as 8, 7, 6, or 5 bits. It is relevant only 

for asynchronous framing. 

Stop Bits specifies the numberof stop bits being usedineach byteofdataas 1,1.5, or2. Itis 

relevant only for asynchronous framing. 

Parity specifies the parity setting being used as None, Odd, or Even. It is relevant only for 

asynchronous framing. 

Baud Rate specifies the speed {in bits per second) that the Chameleon will use to transmit or 

receive data, if the Chameleon is configured as a DTE using synchronous 
framing, the Chameleon will match the received dock. 

Pattern specifies the type of data that the Chameleon will transmit or expect to receive on 

the line: 

• Pseudo-random bit pattern of 63, 511, 2047, 4095, or 32767 bits in 
length 

• The pattern 1010101 

• The FOX message: THE QUICK BROWN FOX JUMPS OVER THE 
LAZY DOG 1234567890 CR 

• A user-defines pattern of 3 - 200 bytes in length. 

Error Insertion Rate In Synchronous Framing only, sets the rate at which errors are automatically 

inserted into the bit stream. There are seven options available: 

FI None No automatic insertion of errors. 

F2 1.Q4E-2 Errors inserted at the rate of 1040 in every 100,000 bits. 

F3 1'Q2E-3 Errors inserted at the rate of 102 in every 100,000 bits. 

F4 1.00E-3 Errors inserted at the rate of 1 00 in every 100,000 bits. 

F5 9.84E-4 Errors inserted at the the rate of 98.4 in every 1 00,000 bits. 

F6 1.0GE-4 Errors inserted at the the rate of 10 in every 100,000 bits. 

F7 1.00E-5 Errors inserted at the the rate of 1 in every 100,000 bits. 

NOTE: You must enter the F4 key of the BERT Setup Menu in order to activate the 

F8 key of the Run-Time Menu for toggling error insertion on aid off. 

User Defined 

Preamble enables you to enter a 2-byte preamble which may be required by the 

remote device in order to synchronize the line. 

User Preamble appears only when the User Defined Preamble parameter is YES. Enter the 

2 hex bytes for your required preamble and press Return. 

Block Length specifies the block length required for your testing application, in the range 

is 0 - 64k bits 

Mode determines what the Chameleon will do during the testing session. The 

options are: 
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BERT APPLICATION (continued) 


FI REMOTE 


F2 LOCAL 

F3 RECEIVE 
Duration of Test 


The Chameleon generates the BEFIT pattern and transmits it to the remote 
device. This device then returns the original pattern to the Chameleon, or 
generates a new one as transmits it back, in either case, the Chameleon 
does a validity check of the pattern. 

The Chameleon waits to receive a BERT pattern. It then synchronizes on 
that pattern, checks its validity, and re-transmits the pattern to the remote 
device. 

The Chameleon synchronizes on a received BERT pattern and checks its 
validity. No pattern is generated by the Chameleon. 

Determines how long test runs in continuous mode (see F2 Contins). Only 
indicates test duration. Enter in the format hh:mm:ss. 00:00:00 causes 
test to run until manually stopped (see F3 Stop). Maximum duration is 97 
hours, 59 minutes, and 59 seconds (97:59:59). 


There are two BERT run-time pages which display the statistics resulting from the Chameleon’s analysis of 
the data received on the iine. The function keys for the two BERT run-time pages are identical, as follows: 

FI 1 block is relevant for Remote Loopback and Local Loopback testing. It causes the 

Chameleon to transmit one block of data to the remote device. 


F2 Contins 

F3 Stop 
F4 Ins Err 

F5 Resync 
F6 Reset 

F7 Setup 
F8 Err off/on 

F9 Next 
F10 Exit 


In Remote Loopback mode, this causes the Chameleon to transmit data 
continuously. In Local Loopback mode, the Chameleon will begin to transmit 
data continuously once the line is in sync. 

stops continuous testing mode. To continue, press F2 Contins. 

causes the Chameleon to transmit an errored bit into the data being 
transmitted to the remote device. 

causes the Chameleon to attempt to resynchronize the line. 

resets all statistical fields in both pages to zero. In continuous mode, it resets 
all statistical fields and automatically resumes testing. 

stops the test session and exits to the BERT Setup menu. 

toggles the insertion of errors cwand off. In Synchronous Framing only, this 
key is activated whenever Error Insertion Rate keys F2 through F7 are 
pressed. 

toggles between the two run-time pages. 

stops the BERT application and returns you to the Applications Selection 
menu. 


The top of both run-time pages display identical fields. These fields are: 

Elapsed 

Seconds displays the number of seconds which have elapsed since tire test was 

started. 


Time 

Mode 

Pattern 

Block 

Length 

User 

Preamble 

Status 


displays the system time as derived from the Chameleon dock, 
displays the current testing Mode as configured in the Setup menu, 
displays tine current Pattern as configured in the Setup menu. 

This field displays the current Block Length. 

displays the User Preamble as configured in the Setup menu. 

displays the testing status between the Chameleon and the remote device. 
It will display one of the following: 
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BERT APPLICATION (continued) 

Idle The Chameleon is not actively performing a test. 

No Sync The test is proceeding, but the line is not synchronized. 

In Sync The line is synchronized and the test is proceeding. 

In addition to the above fields, the first BERT run-time page displays these additional fields: 

Number of Bits: 

For Transmit, this field displays the total number of bits transmitted by the Chameleon to the remote 
device. For Receive, this field displays the total number of bits received by the Chameleon from the 
remote device. 

Errored Bits: 

For Receive, this field displays the number of errored bits received from the remote device according to 
the data pattern in use. For Transmit this field displays the number of errored bits transmitted by the 
Chameleon to the remote device. To transmit an errored bit from the Chameleon, you must press the F4 
Ins . Err key. 

Bit Error Rate: 

For Receive, this field displays the number of errored bits received since the beginning of the test 
session, or since tie run-time display was reset using F6 Reset It is calculated as the ratio of the 
number of bit errors to the total number of bits received. For Transmit, this field is not applicable. 

Number of Blocks: 

For Transmit this field displays the total number of blocks transmitted by the Chameleon to the remote 
device. For Receive, this field displays the total number of blocks received by the Chameleon from the 
remote device. 

Eas iest Block s; 

For Receive, this field displays the number of blocks received from the remote device with one or more 
bit errors. For Transmit, this field is not applicable. 

Block Error Rate: 

For Receive, this field displays the number of errored blocks received since the beginning of the test 
session, or since F6 Reset was pressed. For Transmit, this field is not applicable. 

The second BERT run-time dispfays additional statistics based on the bit error rate of the received data. 

Error Free Seconds: 

This field displays the number of available seconds in which no bit errors have occurred on the line. 
Errored Seconds: 

This field displays the number of seconds in which at least one bit error has occurred. 

Se verely Erro r Secon d s; 

This field displays the number of seconds in which an available second has a bit error rate worse then 
10E-3. 

Consecutively Severely Error Seconds: 

This field displays the number of consecutive seconds with bit error rates worse then 1 0E-3. 
Degraded Minutes: 

This field displays the number of degraded minutes. A degraded minute is a 60-second block of 
non-severeiy errored available seconds in which the average bit error rate, measured over the 60 
seconds, is worse than 10E-6. 

Unavailable Seconds: 

This field displays the number of unavailable seconds. An unavailable second is a second in which the 
line quality is degraded enough that the Chameleon received data with more than 1 0 consecutive 
severely errored seconds. 



DIRECT-TO-DISK APPLICATION 


The Direct-to-Disk application stores a maximum of 30 Mbytes of traffic acquired from the line to the hard 

disk. Once stored to disk, traffic can be played back and analyzed off-line. 

Recording Traffic with Direct-to-Disk 

1 . Configure the desired port for Monitoring from the line or for Simulation. 

2. Press Go to display the Applications Selection page. 

3. Move the red arrow cursor to the DIRTDSK application and press the function key that loads the 
application for the appropriate port 

4. Load additional applications, as desired. 

5. Press Go. This starts the tasks that are loaded, including Direct-to-Disk. Trafficis saved in aspecial 30 
Mbyte area of the hard disk. 

6. To stop recording traffic, select the Configuration page, and stop the Direct-to-Disk application. Do not 
restart the Direct-to-Disk application, or it will overwrite the data that is currently in the Direct-to-Disk 
area of the hard disk. 

7. This traffic can be replayed directly from the hard disk, or saved in a file. To record additional data to 
disk, first save the data that is stored in the Direct-to-Disk portion of the hard disk by following the steps 
below. 

Saving Direct-to-Disk Data to a File 

1. If necessary, stop the Direct-to-Disk or the Direct-from-Disk application. You cannot save 
Direct-to-Disk data if either application is running. 

2. Press Utilities to invoke the Utilities menu. Select and display the Utilities menu. 

3. Press F4 Traffic Load/Save to display the Traffic Operations menu. 

4. Press FI Save to select the Operation. 

5. Enter a file name and press Return. The file is saved to the hard disk unless you specify b : as part of the 
file name for the floppy disk drive, {If you save to a floppy disk, the maximum traffic file size is 700 
Kbytes. To save more than 700 Kbytes to floppy disks, back up the Direct-to-Disk area of the hard disk 
using the Utilities F8 Backup/Restore option.) 

6. Press FI Direct-to-Disk to select the Data Source. 

7. To save less than 100% of the Direct-to-Disk data, press DeteteXo erase the current percentage, enter 
the new percentage, and press Return. This percentage represents the most recently recorded traffic. 

8. Press Go and the traffic is saved with the size of the file in Kbytes displayed. 

9. To replay traffic saved to a file, you must load the traffic back to the Direct-to-Disk area of the hard disk 
as described on the next page. 
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DIRECT-TO-DISK APPLICATION (CONTINUED) 

Replaying Direct-to-Disk Traffic 

1. If you want to repiay data currently stored in the Direct-to-Disk area of the hard disk, go to step 2. 

If you want to repiay data saved to a traffic file, first load the traffic file to the Direct-to-Disk area of the 
hard disk, as follows: 

a. Press Utilities to invoke the Utilities menu. Select and display the Utilities menu. 

b. Press F4 Traffic Load/Save to display the Traffic Operations menu. 

c. Press F2 Load to select the Operation. 

d. Enter a name for the traffic file (including file extension) . 

e. Press Go and the file is loaded into the Direct-to-Disk area of the hard disk. 

(If you used Utilities F8 Backup/Restore to save Direct-to-Disk traffic to multiple floppy disks, use the 
F8 Backup/Restore to restore the data to the hard disk.) 

2. Configure the Chameleon for Monitoring, selecting the appropriate protocol and port for the recorded 
data 

3. In the main configuration page, for the Monitoring Data Source parameter press F2 Disk to select 
monitoring from disk. 

4. Press Go to display the Applications Selection page. 

5. Load the Monitoring applications that you want to use to analyze the traffic on disk. 

6. Press Go to start the monitoring applications. 

7. You can now use the application pages as though you were mon iioring from the line. The Run/Stop key 
starts and stops acquisition from the disk. 

8. When the entire contents of the Direct-to-Disk area has been replayed, acquisition stops. You can 
repiay the traffic again by selecting the Configuration page and pressing F6 Reset 
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STATISTICS 

The Statistics application is available for the protocols listed below. 


PROTOCOL 

APPLICATION NAME 
(IN MENU) 

STATISTICS PAGES AVAILABLE 

BSC 

BSCSTAT 

BSC Line Statistics 
BSC CU Statistics 

ISDN 

Q921STAT 

Q.921 Line Statistics 
Q.921 SAPI 0 Statistics 
Q.921 SAP1 16 Statistics 
Q.921 SAPI 63 Statistics 
Q.921 Other SAPI Statistics 

Primary Rate Interface 

PRISTAT 

PRI Error Statistics 

SNA 

SNASTAT 

SNA Session Statistics 
SDLC Line Statistics 
Session PU Statistics 
SNALU Statistics 
SDLC PU Statistics 
SNA LU Line 

SS#7 

SS7STAT 

SS7 Line Statistics 

X.25 

X25STAT 

X.25 Line Statistics 
HDLC Line Statistics 
X.25 LCN Statistics 


In addition to the Statistics data-dispiay screen for these protocols, a Performance Page is available for X.25, 
SNA, SS7 and ISDN Q.921 . 

To display the Performance Page: 

1 . With the appropriate Protocol Statistics Page banner selected, press Ctrl P. The Performance Page 
banner appears on-screen. 

2. Select the Performance Page banner and scroll it onto the screen, or press Shift Move t 
To dose the Performance Page: 

1 . With the Protocol Statistics page on-screen but NOT in blow-page mode (if it is in this mode, press 
Shift Movel" to anul that mode), select the Statistics Page banner. 

2. Press Ctrl P. The Performance Page is closed. 
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STATISTICS 


The (unction keys for ail Statistics pages are similar (except in PRI statistics). A sample X.25 Statistics page with (unction key descriptions is provided below. 


Most recent packet 
received from high- 
lighted address. 


Displays addresses 
so that you can 
activate statistics 
pages for them. 


X.25: LCNs 
SNA: PUs/LUs 
BSC: CUs 
ISDN: SAPIs 


n 


u 

X.25 LINE STATISTICS 

M 6.;-*** 1 w l 


START TIME: 0 0:00:00:000 000 AM 
LCN: I flOa 008 


LAST TIME: 00:00:00:000 000 AM 


CALL CALL CONFIRM 



M CLEAR CLEAR CONFIRM 


CALLS PLACED: 0 
DCE PACKETS: 0 


CALLS ACTIVE: 00 
DTE PACKETS: 0 


DATA PKT: 0 



DATA PKT: 0 

f§§ 


a 4 — 


OVERHEAD: 0 



OVERHEAD: 0 

in 

nr 





DTE; 

AVG 


LAST 

MAX 

MIN 

PACKET RETRIES: 

0 

0 

ACCESS; 0.000 

0.000 

0.000 

0.000 

RESET: 

0 

0 

CLEAR: 0.000 

0.000 

0.000 

0.000 

RESTART: 

0 

0 

SESSION: 0.000 

0.000 

0.000 

0.000 

PRNR: 

0 

0 

PACKET RESP: 0.000 

0.000 

0.000 

0.000 

PREJ: 

0 

0 

DCE LEN: 00000 

00000 

00000 

00000 

PRR: 

0 

0 

DTELEN: 00000 

00000 

00000 

00000 

DIAG: 

0 

0 

DATA BYTES/SEC: 0 





DCE UTILIZATION: 0% 


DTE UTILIZATION: 0% 





DCE DATA: 0% 


1 

DTE DATA: 0% 

ilss 




DCE OVERHD: 0% 

ill " 


DTE OVERHD: 0% 

C 





LCNS 

HDLC 

. 

PR 

; i 

INT 

L J 

RESET 

lk> 

TIME 

J 

PACKET? 





x zzz: 

— 


Displays protocol 
layer so that you can 
activate statistics 
pages for it. 


Prints a statistical re- 
port if the Chameleon 
is configured for, and 
connected to a printer. 


Resets all values and 
timers to zero for all 
statistics pages for 
that protocol. 


Displays time or 
date and time 


.Current call status is 
highlighted. 


Graphic representation 
of statistics data 


Determines whether the number 
of PACKETS or number of 
BYTES is displayed for DCE/ 
DTE Packets, Data Packets, and 
Overhead. 


X.25; HDLC 
SNA: Session 
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TRIGGERING APPLICATION 

TRIGGER STRUCTURE 


Name 


Status 


1-4 Conditions 


1-4 Actions 

1—4 character 


1 si Time 


Selected by function 


Executed if all trigger 

default or user- 


Enable to fire once 


keys. (See below 


conditions are met. 

spedfied name 


Disable 

Whenever 


and next page.) 


Selected by function 
keys. (See below.) 



Enable forever 





TRIGGERING LOGIC 



ft 


! trgl 


I trg2 


Condition 1 AND Condition 2 AND 
Condition 3 AND Condition 4 




OR 



Condition 1 AND Condition 2 AND 
Condition 3 AND Condition 4 

- » « 4 




CONDITIONS See next page tor function key map. To use logical NOT condition, press Shift-function key. 


DTE/DCE Triggers on either DCE events, DTE events, or both. 

Error Triggers on CRC and frame abort errors. 

Counter Triggers on a user-defined counter value. 

Timer Triggers on a user-defined timer value. 

RLTime Triggers on Real-time Clock value. 

Frame Triggers on user-spedfied data string in a frame. 

Frameien Triggers on frame length in bytes. 

Protocol Protocol-specific options for X.25, HDLC, Q.921 , Q.931 , SS#7, or DASS 2. 
Variable Compares an integer variable with another variable or constant. 

Leads Triggers on interface lead states or changes. 

Port Triggers on events from Port A, Port 8, or both. 


ACTIONS Arm 
Stats 
Display 
=>Disk 
Mesg 
StopAcq 
IncCnt 
ResCnt 
Timer 
SetVars 
V Arfth 
TrigOut 


Arms (enables) another trigger. 

Processes event, prints a report, or resets the statistics application. 
Displays events in the Real Time page. 

Records events to the Direct-To-Disk area of the hard disk. 

Displays the message “Trigger Fired” and beeps. 

Stops the acquisition of traffic from the line. 

Increments the specified counter by one. 

Resets spedfied counter. 

Starts, stops, or resumes a spedfied timer. 

Stores a value to a variable. 

Change the value of one of the integer variables. 

Sets Chameleon to signal remote monitoring device upon detection of 
triggering event. 
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TRIGGERING CONDITIONS (Function Keys) 


DTE/DCE 

Error 

DTE 

CRC 

DCE 

FAbort 


Counter 

Timer 

RLTIme 

Define 
user 
counter 
1 ,2,3, or 4 

Define 
user 
timer 
1 ,2,3, or 4 

> = or 
< s= 

specified 

system 

time 


FramLen 


Frame 


Protocol 


Variable 


Leads 


Port 


Float 


Const 


Starting 

— iade_ 


AscSIr 


EbcStr 


Hex 


Dec 


Binary 


Variable 


> =, 

< >=, 

< 

specified 

length 


$7 


$8 


±1 


HDLC 


1-Frame 

RR 

RNR 

REJ 

SABM 

DISC 

FRMR 

UA 

DM 

SABME 

P/F 


$9 


X.25 


Call Req 
Call Con 
Clr Req 
Clr Con 
Data 
Intrupt 
Intrupt C 
RRP 
RNRP 
REJP 
Reset 
Reset C 
Subserb 
Q Bit 
D Bit 
MBit 


Q.921 


1-Frame 

RR 

RNR 

REJ 

SABM 

DISC 

FRMR 

UA 

DM 

SABME 

P/F 

SAPI 

TEI 

C/R 


Q.931 

DASS2 

ProDisc 
CR Flag 
CR Value 
Msg Type 

Message 

(time 

slot) 



$7 


$8 


Select lead: 
dt, rt, ct, ds, 
cd, sq, ri 


Port A 


Port B 


$9 


High 


Low 


To High 


To Low 







1 W?i 




m L2 


FSN 
BSN 
FIB 
BIB 
FISU 
LSSU 
MSU 
LSSU SF 


#7 L3L4 


See 

detail on 
next 
page. 


TUP* 

ISUP* 

DPC 
OPC 
CiC 
H0H1 
Add Sig 
Tel.Num. 

DPC 
OPC 
CIC 
H0H1 
Add Sig 
Tel.Num. 


* When a protocol other than SS7 Is selected in the Setup 
Menu, keys Ffland F9 are TUP and fSUP, as shown. 
However, when SS7 Is selected as the Setup protocol, 
these two keys reflect the SS7 standards listed below. 


Standard. 




JE9 


CCITT (84 or 88) 

NCC 

NTT 

ANSI 

1TR7 


CT TUP 
NCC TUP 
NTT TUP 
ASN TUP 
TR7 TUP 


CT ISUP 

NCCISUP 

NTTISUP 

ANSISUP 

TR7ISUP 
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SS#7 LEVEL 3 AND LEVEL 4 TRIGGERING OPTIONS 
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SIMULATOR ROAD MAP 



NEXT STEP 

If you are here: 

And you want to: 

Do this: 

FRAMEM, 

SIMP/L 

BSC, or 

Async 

simulation 

prompt! 

Stop the simulator 

Enter: MENU <RETURN> OR 

Access the Configuration page, move the red 
arrow cursor to the simulator name, and press 
the function key that stops the simulator on 
the desired port. 


Access the parameter set-up 
menu 

Enter SETUP <RETURN> 


Write programs 

Read the Chameleon 32 Simulation Manual 
(Chapter 3) for Chameleon BASIC 
fundamentals AND read the chapter that 
describes your simulation language. 

SITREX 

SIMULATOR 

ACTIVE 

Return to the main menu 

Enter: PS <RETURN> 
HALT <RETURN> 


Access the parameter set-up 
menu 

Enter: PS <RETURN> 
HALT <RETURN> 
Press: F2 
GO 


Enter command mode (!) 

Enter PS <RETURN> 


Exit command mode 

Enter EXIT <RETURN> 


Activate the trace buffer 

Enter PP <R£TURN> 


Deactivate the trace buffer 

Enter CTRL P 

Any Parameter 
Set-Up Menu 

Access the simulation 
prompt (!) to write programs 

Press: Z 


Return to the main menu 

Press: ESC 


Change parameter values 

Read the Chameleon 32 Simulation Manual 
(Chapter 2.2) for general information about 
the set-up menus AND read the chapter that 
describes the menu for the simulation 
language you are using. 


Save parameter values 

Press: S 
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FRAMEM LAPD DEFAULT MNEMONIC TABLE 


The Wield column in the table indicates whether the mnemonic can have an Wield. If an Wield is permitted 
(using the DEFINE command), the letter I appears in the i— Field column. 


MNEMONIC 

1-FiELD 

DECIMAL 

HEX 

BINARY 

FRAME 


0 

00 

00000000 

SNRME 


207 

CF 

11001111 

SARME 


79 

4F 

01001111 

SABME 


111 

6F 

01101111 

SREJ 


13 

OD 

00001101 

SNRM 


131 

83 

10000011 

SARM 


15 

OF 

00001111 

SABM 


47 

2F 

00101111 

DISC 


67 

43 

01000011 

RSET 


143 

8F 

10001111 

FRMR 


135 

87 

10000111 

TEST 


227 

E3 

11100011 

CMDR 


135 

87 

10000111 

RNR 


5 

05 

00000101 

REJ 


9 

09 

00001001 

SIM 


7 

07 

00000111 

X1D 


175 

AF 

10101111 

RIM 


7 

07 

00000111 

NSI 


3 

03 

00000011 

RQI 


7 

07 

00000111 

ROL 

1 

15 

OF 

00001111 

NSP 


35 

23 

00100011 

RR 


1 

01 

00000001 

U! 


3 

03 

00000011 

UP 


35 

23 

00100011 

DM 


15 

OF 

00001111 

UA 


99 

63 

01100011 

RD 


67 

43 

01000011 
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FRAMEM HDLC/SDLC MNEMONIC TABLE 

The DEFSUB column can reference a line number. If this type of frame is received, program control jumps to 
the program line number specified in this column and executes the subroutine. Refer to the FRAMEM 
DEFSUB command for more information. 


MNEMONIC 

DECIMAL 

HEX 

BINARY 

DEFSUB 

(FRAME 

0 

00 

00000000 


SNRME 

207 

CF 

11001111 


SARME 

79 

4F 



SABME 

111 

6F 

01101111 


SREJ 

13 

0D 

00001101 


SNRM 

131 

83 

10000011 


SARM 

15 

OF 

00001111 


SABM 

47 

2F 

00101111 


DISC 

67 

43 

01000011 


RSET 

143 

8F 

10001111 


FRMR 

135 

87 

10000111 


TEST 

227 

E3 

11100011 


CMDR 

135 

87 

10000111 


RNR 

5 

05 

00000101 


REJ 

9 

09 

00001001 


SIM 

7 

07 

00000111 


XID 

175 

AF 

10101111 


RiM 

7 

07 

00000111 


NSI 

3 

03 

00000011 


RQI 

7 

07 



ROL 

15 

OF 

00001111 


NSP 

35 

23 

00100011 


RR 

1 

01 

00000001 


Ul 

3 

03 

00000011 


UP 

35 

23 

00100011 


DM 

15 

OF 

00001111 


UA 

99 

63 

01100011 


RD 

67 

43 

01000011 
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S1MP/L LAPD DEFAULT MNEMONIC TABLE 



FIELD WIDTH 
(BITS) 

DEFINITION/ Q.931 MESSAGE OCTET 

MESTYP 

7 

Message type/fourth octet 

SHFTID 

3 

Shift 10/fourth octet (Shift info, element) 

LOKBIT 

1 

Shift lock bit/fourth octet (Shift info, element) 

CODSET 

3 

Code set/fourth octet (Shift info, element) 

CRLEN 

4 

Call reference length/second octet 

CREF7 

7 

Call reference/third octet 

CREF8 

8 

Cali reference/third octet 

NOEXT 

1 

No extended bit/fourth octet filler 

PDIS 

8 

Protocol discriminator/first octet 

FIL4 

4 

Four bit filler/second octet 

PAD1 

1 

One bit fiiler/fourth octet filler 

PAD2 

2 

Two bit filler 

EXT 

1 

Extend bit 

Rl 

16 

Reference number/TEI field 

Al 

7 

Action indicator/TEI field 


SIMP/L HDLC DEFAULT 
MNEMONIC TABLE 


MNEMONIC 


FIELD WIDTH 
(BITS) 






































































BSC DEFAULT MNEMONIC TABLE 



T.H.TTOK 

HEX 


ACKO 

112 

70 

01110000 

ACK1 

97 

61 


WABT 

127 

7F 


SOH 

1 

01 

00000001 

STX 

2 

02 

00000010 

ETB 

38 

26 

00100110 

ETX 

3 

03 

00000011 

ITB 

31 

IF 

00011111 

EOT 

55 

37 

00110111 

ENQ 

45 

2D 

00101101 

DUE 

16 

10 


SYN 

50 

32 



46 

2E 

00101110 

NAK 

61 

3D 

00111101 
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BASIC COMMANDS 


PILES Lists the files on a specified disk drive. 
FILES A Lists files on hard disk 
FILES B Lists files on floppy disk 

FLIST Lists the ten function key 

assignments 
FLIST 

FLOAD Loads a function key 

definition file into memory. 

FLOAD “filename" 

FLUSH Clears the acquisition 

buffer. 

FLUSH 

FOR Controls looping in 

programs. Must be used with NEXT 
FOR x=exp1 TO exp2 [STEP exp3] 

NEXT X 

X is a numeric variable 
expl is the beginning value of x 
exp2 is the maximum value of x 
exp3 is the step increment 
FREE Read-only variable that 

returns the number of free mnemonic 
table entries. 

PRINT FREE 

IF FREE.. 

FSAVE Saves function key 

assignments. 

FSAVE “filename” 

GOSUB Sends program to a 

specific line number to execute a 
subroutine. 

GOSUB exp 

exp » fine number 

GOTO Sends program control to a specific line 
number. 

GOTO exp 

exp =• line number 

HEX$ Creates an ASCII 

4— character string which is the HEX 
equivalent of exp. 

$A = HEX$(exp) 

HEX Assigns a string variable 

value in hexadecimal. 

$A = HEX>exp 

HLF Causes text to be 

displayed in double intensity (highlight) 
HLF 

HLFUND Displays text in double 
intensity and underlined. 

HLFUND 

IF Allows program flow to 

be changed based on a decision. 

IF x op y command 
x and y are numeric variables 
op is a logical or arithmetic operator 
command is the command to execute 
if the statement is true 


INKEYS Assigns the next character typed on 
the keyboard to a string variable. 

$A=INKEY$ 

INPUT Stores keyboard input in a variable. 

INPUT “prompt”, x 

prompt is the text that you want displayed 
(optional) 

x is the variable that stores the keyboard input 
, displays the variable name (optional) 

S1NPUT Assign a string variable from the 
keyboard. 

SINPUTSA 

INS Inserts a blank line on the screen. 

INS 

INSTR Returns the offset (position) of a 

substring within the main string, 
x =. INSTR(str1 ,str2) 
str1=«main string 
str2=» substring. 

KILL Deletes a file from disk. 

KILL”filename”,x 

x is the file type: 

P Program 

T Trace 

M Mnemonic table 

D Data 

S Setup (parameter) 

F Function key definition 

A All types 

LEFTS Assigns a specified number of 

characters from the left end of one string to 
another string. 

$A m LEFT$($x,exp) 

exp =* number of characters from the left end of $x 

LEN Assigns the length of a string 

variable to a numeric variable. 

A» LEN($x) 

$x is a string variable 
A is the numeric variable 

LET Assigns values to numeric or string 

variables. 

LET x = exp Numeric variable 
LET $A a “xxx” String variable 

LF1LES Outputs file directory to printer. 
LFILES A Prints hard disk directory 
LF1LES B Prints floppy directory 

LFL3ST Outputs current function key 
assignments to a printer or remote device. 

LFUST 




BASIC COMMANDS 


LIST Displays program in memory. 

Lists entire program. 

LIST x Lists program from line x to 

end. 

LIST x,y Lists program from line x to 
line y. 

LIST ,y Lists program from 

beginning to line y. 

LUST Outputs program in memory to a printer. 

LUST Prints entire program. 

LUST x Prints program from line x 

to end. 

LLIST x,y Prints program from line x 
to line y. 

LUST ,y Prints program from 

beginning to line y. 

LMLJST Outputs the mnemonic 

table in memory to a printer. 

LMUST 

LOAD Loads a program file into memory. 

LOAD “filename” 

LTPRINT 

Outputs the contents of the trace buffer to a 
printer. 

LTPRINT 

MENU Exits the simulator and returns to the main 
menu. 

MENU 

MERGE Combines a program file with the program in 
memory. 

MERGE”fifename” 

MIDS Assigns characters from the middle of a string 
to a string variable. 

$A s MlD$($x,axp1,exp2) 

expl is the position of the first character 
axp2 is the number of characters 

ML1ST Displays the mnemonic table in memory. 
MUST 

MLOAD Loads a mnemonic table into memory. 
MLOAD”filename” 

MSAVE Saves the mnemonic table in memory to disk. 
MSAV£”fiiename " 

NEW Deletes the program in memory. 

NEW 

NEXT Increments the counter in a FOR loop. 

NEXT x 

NRM Cancels display effects commands (blinking, 
underline, double intensity). 

NRM 

OPEN Opens a data file. 


OPEN “1”, "filename” Opens a file 

for input 

OPEN “O’Y’filename” Opens a new 

file for output. 

OPEN “A”, ’’filename” Opens file for 

output to the 
end of the 
file. 

PRINT Displays a string, expression, or variable. 

PRINT” string” Prints the string. 
PRINT $A Prints string variable. 

PRINT x Prints numeric 

variable. 

PRINT %x Prints X in hex. 

Options; 

, acts as a field separator 
\)suppresses a line feed 
; suppresses the carriage return 

READ Reads next record from an input file. 

READ $A 

REC Protocol-specific command that transfers data 
from the acquistion buffer to the trace buffer. 
REM Programmer's internal remark. 

REM comment 

RESEQ Re-numbers the line numbers of the program 
in memory. 

RESEQ Start at line 1 0, increment by 

10 . 

RESEQ {EXPR1} Start at x, 
increment by 10. 

RESEQ {EXPR1 } {EXPR2} Start at x, 
increment by y. 

RETURN 

Returns program control from a subroutine 
called by a GOSUB. 

RETURN 

REV Displays text in reverse video. 

REV 

REVHLF 

Displays text in reverse video in double 
intensity. 

REVHLF 

REVUND 

Displays text in reverse video and underlined. 
REVUND 

RIGHTS Assigns a specified number of characters from 
the right end of one string to another string. 
$A 3 RIGHT$<Sx,exp) 

$x is the string 

exp defines the number of characters from 
the right 

RND Returns a random number. 

RNDfx) 





RUN Executes the program in memory. 

RUN 

SAVE Saves the program in memory to disk. 
SAVE “filename” 

SET Sets physical interface signal to 1 or 0. Not 
available in SIMP/L or FRAMEM DM!. 

SET xxx = y y is a 1 or 0 
xxx is one of the following: 

GTS (DCE) 

DSR (DCE) 

DCD (DCE) 

R1 (DCE) 

SDCD (DCE) 

DTR (DTE) 

RTS (DTE) 

SETUP Accesses the parameter set-up menu. Not 
available in FRAMEM DMI. 

SETUP 

SIZE Returns size of free program area in bytes. 
PRINT SIZE 

IF SIZE... 

STOP Terminates program execution. 

STOP 

TEST Tests an interface signal for 1 or 0. 

TEST xxx = y command 
y is 1 or 0 

xxx is one of the following: 

CTS DTE) 

DSR (DTE) 

DCD (DTE) 

Rl (DTE) 

SDCD (DTE) 

DTR (DCE) 

RTS (DCE) 

command is the command to execute 
when the TEST condition is true. 

TFREE Returns the length of the unused trace 
buffer in bytes. 

PRINT TFREE 

IF TFREE.. 

TIMQ Timer which counts down in ten millisecond 

(.01) intervals 
TIMQ = x 

T1M1 Timer which counts up in ten millisecond 
(.01) intervals 
T1M1 s x 


T1M2 Timer which counts down in seconds 
T1M2 = X 

T1M3 Timer which counts up in seconds 
T1M3 = X 

TIME Read-only variable that returns a specified 

byte of the system time in BCD digits. 
TlME(x) 

X is in the range 0 to 4 and specifies Tie 
unit of time, as follows: 

0— hours 

1 ~ minutes 

2 - seconds 

3 — 1/1 00s seconds (.01 ) 

4— 1 0s of milliseconds (.0001 ) 

TIMES Assigns the current time to a string 
variable. 

TIMES 

TLOAD Loads a trace file into memory. 
TLOAD”filename” 

TPRINT Displays the contents of the trace buffer. 
TPRINT 

TROFF Turns off the program trace facility (debug 
mode). 

TROFF 

TRON Turns on the program trace facility (debug 
mode), 

TRON 

TSAVE Saves the contents of the trace buffer to a 
trace file. 

TSAVE "filename" 

UND Displays text in undertine. 

UNO 

PRINT UND text 

VAL Converts a numeric ASCII string to its 
integer form. 

A= VAL(SA) 

WRITE Writes a string variable to a data file opened 
for output. 

WRITE $A 

XYPLOT 

Moves the cursor to a specified postion on 
the screen. 

XYPLOT(y,x) 

y =» y-coordinate (row), range 0-21 
X » x-coordinate (column), 
range 0 -79 






ABORTRAN 

Transmits a frame with an abort sequence. 
The frame must be greater than 4 bytes in 
length. 

ABORTRAN 

BADTRAN 

Transmits a frame with a bad CRC. .The 
frame must be greater than 4 bytes in length. 
BADTRAN 
BADTRAN $A 

CRC Indicates if received frame had a good or 
bad CRC. 

CRC=0=*Good CRC 
CRC-1 =Bad CRC 
PRINT CRC 
IF CRC... 

DEFINE Defines new mnemonics or redefines 
existing mnemonics. 

DEFINE "NAMEMmx LAPD 
DEFiNE”name”=x All others 

name ^mnemonic name 
X is a numeric expression 
Ut-fieia permission (LAPD) 

DEFSUB 

Defines the line number to jump to when the 
received frame matches a specific 
mnemonic. 

DEFSUB"NAME”=xxxx 

rtame*defined mnemonic 
xxxx*4ine number of program to 
execute if that mnemonic is received 

EXTEND 

Selects extended mode addressing. 
EXTEND 

GET Gets two bytes (low byte, high byte) from an 
Meld, 

X=GET exp 

PRINT GET exp 

MOD Specifies modulo 8 or modulo 128 
sequencing. 

MOOS 

MODI 28 

NORM Selects normal mode addressing. 

NORM 

PUT Defines a specified byte in an Mieid for 
transmission. 

PUT exp1,exp2 

expl-byte no. from start of Mefd 
exp2=vaiue assigned to that byte 

REC Assigns the next received frame in 
sequence from the acquisition buffer and to 
0 or more string variables. 

REC SA, SB... 


RXADDR 

Address field of the received frame. 

PRINT RXADDR 

IF RXADDR„. 

RXC/R C/R bit extracted from an FRMR field. 
PRINT RXC/R 
IF RXC/R... 

RXDIAGLast byte of an FRMR (WXYZ bits) 

PRINT RXDIAG 

IF RXDIAG... 

RXFCTL Control field of the received frame without the 
poll/final bit, N(S), and N(R). 

PRINT RXFCTL 

RXFRLEN 

Length of the received frame. 

PRINT RXFRLEN 
IF RXFRLEN... 

RXN(R) N(R) of the received frame, if a supervisory 
frame or an Wrame. 

PRINT RXN(R) 

RXN(S) N(S) of the received frame, if a supervisory 
frame or an Wrame. 

PRINT RXN(S) 

RXP/F Poil/finai bit of the received frame. 

PRINT RXP/F 

IF RXP/F-. 

RXRFCTL 

Rejected frame control field of the received 
frame. 

PRINT RXRFCTL 
IF RXRFCTL... 

RXRP/F Poll/final bit of a received rejected frame 
control field. 

PRINT RXRP/F 
IF PXPR/F 

RXV(R) V(R) of the rejecting station for a rejected 
frame. 

PRINT RXV(R) 

IF RXV(R).- 

RXV(S) V(S) of the rejecting station for a rejected 
frame. 

PRINT RXV(S) 

IF RXV(S)... 

STATUS Displays the current addressing mode and 
modulo. 

STATUS 

TPRINT Displays the contents of the trace buffer. 
TPRINT 












FRAMEM DMI COMMANDS 


FRAMEM DM1 COMMANDS AND VARIABLES 

CAUSE Returns cause of an on-hook state, 
PRINT CAUSE 
IF CAUSE- 

CAUSE has the following values: 

0 Start of simulation 

1 Call rejected, no match on 
address digits 

2 No wink received before T1 
timeout 

3 No off-hook before T7 timeout 

4 Local disconnect 

5 Remote disconnect 

CHADMIN Defines the call setup mode to use. 
CHADMIN = x 
x Is one of the following: 

0 a Wink-start in/Wink-start out 

1 m Auto-start in/Wink-start out 

2 - Wink-start in/Auto-start out 

3 * Auto-start in/Auto-start out 

CONNECT Performs call setup procedures and 
seizes the channel selected on the 
TE820A. 

CONNECT 

□CALLED Displays the phone number to be 
outpuised (dialed) 

□CALLED 

□CALLING Displays the numbers inpulsed 
(received). 

DC A LUNG 

DISCONNECT Causes the Chameleon 32/TE820A 
to go on-hook. 

DISCONNECT 

DMATCH Displays the numberthe Chameleon 32 
will accept for incoming calls in Wink 
mode. 

DMATCH 

DT1MERS Displays the current timer settings. 

□TIMERS Displays timer settings. 

Txsyy Sets timers, 

x is the timer number, range t - 8 
yy is the value, range 1-99 

T1 Time between an incoming 
seizure and the start of the 
outgoing wink. 

T2 Duration of the wink signal. 

T3 Time between the end of the wink 
signal and the first dial pulse. 

T4 The duration of a break pulse. 

T5 The duration of a make pulse. 

T6 Inter-digit time 

T7 Dialing timeout 

T8 Minimum disconnect time. 


FRAMEM DMI COMMANDS AND VARIABLES 

G LA R E Indicates if a glare condition exists. 

GLARE = Q=No glare condition. 

GLARE = 1=Glare condition 
PRINT GLARE 
IF GLARE.. 

MATCH Specifies which incoming calls will be 
accepted. 

MATCHs'x” 

x is a valid incoming number. 

OUTNUM Sets the number to be outpuised 
(dialed). 

OUTNUM = "x” 

x is the phone number, maximum of 30 
digits 

RESET Clears the acquisition buffer and resets 
the state of the call to its start of 
simulation disconnected state. 

RESET 

R ESPTIME Indicates how busy your switch is. 

PRINT RESPT1ME 
IF RESPT1ME- 

STATE Returns the state of a cal! and the 
operating mode. 

PRINT STATE 
IF STATE... 

Values are: 

1 Disconnected 

2 Outgoing setup 

3 Incoming setup 

4 Dial pulses being received 

5 Dial pulses being sent 

6 Connected 

STATUS Displays the state of the call, the call 
setup mode, the modulo (8 or 128), and 
type of addressing, and glare condition. 
STATUS 









SIMP/L COMMANDS 








S1MP/L COMMANDS 
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SIMP/L COMMANDS 


MULTI-LINK SiMP/L LAPP COMMANDS 

FRELNK Read-only variable that returns the 
number of the lowest disabled link. 
PRINT FRELNK 
IF FRELNK... 

SET LINK = FRELNK 
Returns: 0-63 Link number 

—1 None disabled 

FRSTAT Read-only variable that returns a 2-byte 
frame status value. Interpretation of 
second byte: 


BIT 

7 6 5 4 3 2 1 0 
I L 


High bit/low bit 

00 « Ut frame 

01 *> X1D frame 

10 « Mrame 

11 » CMDR {diag. field) 

Reserved 

0 =* Command frame 

1 m Response frame 

0 = Poil/Final bit clear 

1 m Poli/Final bit set 


V.120 SIMP/L COMMANDS AND VARIABLES 

FRELNK Read-only variable that returns the 
number of the lowest disabled link. 

PRINT FRELNK 
IF FRELNK... 

SET LINK = FRELNK 
Returns: 0-63 Link number 

—1 None disabled 

FRSTAT Read-only variable that returns a 2— byte 
frame status value. Interpretation of 
second byte: 


7 6 


BIT 

5 4 3 


2 1 0 
L_L 


High bit/low bit 

00 = U1 frame 

01 = XID frame 

1 0 a W rame 

11 ■ CMDR {diag. field) 

Reserved 

0 =» Command frame 

1 m Response frame 

0 * Poll/Finai bit dear 

1 =. Poil/Fina! bit set 


RECLNK Read-only variable that returns the 
number of the link from which data was 
last received. 

PRINT RECLNK 
IF RECLNK... 

SET LINK = RECLNK 

SET UNK Places one of the 64 available links under 
user control. 

SET UNK = exp exp is in the range 

0-63 

SET SAPI Sets SAPI value for the selected link. 
SET SAP! = x x is 0-63 

SET TEi Sets TEi vaiue for the selected link. 

SET TEl = x x is 0-127 

STATE Displays states of ail 64 links. 

STATE 

Returns: 0 — 9 (see SIMP/L LAPD 

LNKSTAT for state values) 

STATUS Displays status of selected link. 
STATUS 

Multi-Link also uses these SIMP/L LAPD commands: 

LNKSTAT SET N200 SET N201 

SET T200 SET T203 SET Window 

SET CONFIG TRUI TRXIDC 

TRXIDR TPRINT 


RECLNK Read-only variable that returns the 
number of the link from which data was 
last received. 

PRINT RECLNK 
IF RECLNK... 

SET UNK a RECLNK 

RTRAN Transmits an i— Frame response. The 
C/R bit is set to 0 in command frames 
and 1 in response frames. 

RTRAN 

SET LINK Places one of the 64 available links 
under user control. 

SET LINK a exp exp is in the 
range 0-63 

SET LU Sets the LL) vaiue of the selected link. 

SET LLI a X x is 0-8191 

STATE Displays the states of ail 64 links. 
STATE 

Returns: 0-9 (see SIMP/L LAPD 

LNKSTAT for state values) 

STATUS Displays status of selected link. 
STATUS 

V.120 SIMP/L also uses these SIMP/L LAPD 
commands: 

LNKSTAT SET N200 SET N201 

SET T200 SETT203 SET Window 

SET CONFIG TRUI TRXIDC 

TRXIDR TPRINT 





ASYNC BASIC COMMANDS 


BREAK 

Transmits a BREAK sequence. 
BREAK 

CRC16 

Calculates the CRC for a string 
$B=CRC16($A) 

FOXMESS 

Transmits the standard FOX message and repeats it until the 
operator hits any key. 

FOXMESS 

FRAMING 

Returns a value that indicates the presence of stop bits at the 
end of the received block. 

PRINT FRAMING 
IF FRAMING... 

FRAMING returns: 

FRAMINGS Stop bits 

FRAMING-1 No stop bits 

LENGTH 

Returns the number of characters received in a block. 
PRINT LENGTH 
IF LENGTH... 

LRC 

Calculates the LRC for a string. 
SX = LRC($Y) 

PARITY 

Indicates whether a parity error has occurred. 
PRINT PARITY 
IF PARITY... 

PARITY returns: 

PARITY -0«No parity error 
PARITY -1 -Parity error 

REC 

Assigns the next character (if in character mode) or block of 
characters (if in block mode) to string variables. 

REC $A, SB, $C.„ 

RXBREAK 

Indicates if a break sequence has been received. 
PRINT BREAK 
IF BREAK... 

BREAK returns: 

RXBREAK-O-No break sequence 
RXBREAK-1 -Break sequence 

TPRINT 

Displays the contents of the trace buffer. 

TPRINT Prints the trace in ASCII. 

TPRINT HEX Prints the trace in hexadecimal. 

TRAN 

Transmits data in strings, mnemonics or literal data 
TRAN $A... 

TRAN CR, LF... 

TRAN “ABCD”... 

TRAN $A, CR, LF, “ABCD" 
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BSC BASIC COMMANDS 


CRC1 6 Calculates the two-byte CRC for a string. 

CRC1 6($A) 

IDLE Determines what is transmitted when the line is idle. 

IDLEaSYNC 
IDLErMARK 

LRC Calculates the LRC for a string. 

LRC($A) 

REC Takes the next received block from the acquisition buffer. 

REC 

RXLENGTH Returns the length of the last received block. 

PRINT RXLENGTH 
IF RXLENGTH— 

TPR1NT Displays the contents of the trace buffer. 

TPRINT Displays the trace buffer in hex. 

TPRINT ASCII Displays the trace buffer in ASCII. 
TPRINT EBCDIC Displays the trace buffer in EBCDIC. 

TRAN Transmits a block from the transmission buffer (TXBUFFER), 

according to the framing defined by the transmission control 
status byte (TXSTATUS). 

TRAN 

TXBUFFER Defines the contents of the transmission buffer 
TXBUFFER = DLE 
TXBUFFER = ACK 
TXBUFFER = 0 
TXBUFFER a $A 
TXBUFFER = &10, 3.70 
TXBUFFER a DLE, SA, &70 

TXSTATUS Defines the transmission control status byte, as shown below. 
TXSTATUS a &xx 
TRAN $A, CR, LF, ‘A BCD” 
xx is a hex value 



START FRAMING 

0 = SOH 

1 =STX 

END FRAMING 

00 = EOT 

01 =ETB 

10 = ETX 

1 1 = Illegal 

TEXT MODE ENABLE 

0 = Normal mode 

1 = Transparent mode 

TRANSPARENT MODE 1 

0 = Transparent mode 0 

(No DLE insertion) 

1 3! Transparent mode 1 

(DLE insertion) 

TEXT MODE 

0 = Control mode 

(No BCC) 

1 =t Text mode. 

CRC 

0 = Good CRC 

1 = Bad CRC 


MUST BE 1 





SJTREX COMMANDS 


FRAME LEVEL COMMANDS 


Send User-Defined Frame 

FBb ....b Frame defined in binary. 

PAa„.. a Frame defined in ASCII. 

FHh.„™..h Frame defined in hex. 

Send Unnumbered Commands 

F(P)DiSC Polled/unpoiled D!SC on primary 
address. 

F(P}SABM Poiled/unpolied SABM on primary 
address. 

Send Unnumbered Responses 
F(F)UA UA frame. 

F(F)DM DM frame. 

F(F)CMDRh1 h2(Vs)(,Vr)(8)(WXX)(YXZ) 
CMDR frame. 

Send Numbered Commands 
FPRR(Nr) Sends an RR. 

FPRNR(Nr) Sends an RNR. 

Nr is in the range 0 -7. 

Numbered Responses 

FfF)RNR(Nr) Sends a RNR frame. 

F(F)RR(Nr) Sends a RR frame. 

FfF)REJ(Nr) Sends a Rej frame. 

Nr is in the range 0 -7 

Send Information Frame 

F<P)I( NsX,NrX PA CKET) Packet mnemonic. 

F(P)i(NsX,Nr)(PHh1 h2 ) Packet in hex. 

F(P)l(NsX,NrXPAabcd.„) Packet in ASCII. 

PACKET LEVEL COMMANDS 


Send User-Defined Packet 

PHh. h packet in hex. 

PAa.„ a Packet in ASCII. 


Reset packet. 

Reset Confirmation. 
Interrupt packet. 
Interrupt Confirmation. 


PACKET LEVEL COMMANDS (cont.) 

Send Restart/Restart Confirmation Packets 
PRST(h1h2X h3h4) Sends a Restart packet 
h1h2 » Cause code 
h3h4 * Diagnostic code 
PCRST Restart Confirmation packet. 

Send Clear/Reset/! nterrupt Confirmation 
PUnCL.EAR(h1h2Xh3h4X,DHh...h) 

Clear packet with data in hex. 

PUnCLEARfhl h2Xh3h4)(,DAa...a) 

Clear packet with data in ASCII. 

PUnCCLEAR 
Clear Confirmation packet. 
PUnRSET(h1h2)(h3h4) 

PUnCRSET 
PUnJNT(hfh2Xh3h4) 

PUnCINT 
DA m Data in ASCII 
DH - Data in hex 
h1h2 » cause code 
h3h4 « diagnostic code 

Send Data Packets 

PUnD(PsXPrXQXMXD)Hh.„.h Hex. 
PUnD(PsXPrXQKMXD)Aa....a ASCII, 
n » pseudo-user, range 1 - 7. 

G m Qualifier bit. 

M » More Data bit 
D » Delivery confirmation bit. 

Send Diagnostic Packet 

Sends a diagnostic packet on logical channel 0. 
PDIAGhl Ii2h3h4h5h6h7h8 
hi h2=» diagnostic byte 
h3 - h8 =» first 3 bytes of header information 

DISPLAY AND PRINT COMMANDS 


Send Call/ Call Confirmation Packets 

PUnCALLfDXNa or VX,Nb)<,Fh.„hX,DHh...h) 
PUnCALL(DXNa or V)(,NbX,Fh...h)(,DAa...a) 
Sends a Cai! packet 
PUnCCALLfD) 

Sends a Call Confirmation packet 
n * pseudo-user, range 1-7. 

D - delivery confirmation bit. 

Na «■ called address in decimal 

V » called number configured in SfTREX menu 

Nb m calling number in decimal 

F » called facilities 

DA » Data in ASCII 

DH - Data in hex 

Send Supervisory Packets 

PUnRR(Pr) Sends an RR packet. 
PUnRNR(Pr) Sends an RNR packet. 
PUnREJ(Pr) Sends a Reject packet, 
n » pseudo-user, range 1 - 7. 

Pr, range 0-7 (Mod 8); range 0-1 27 (Mod 1 28) 


Display User Parameters 

DISPT Displays timer values in decimal. 
LDISPT Prints the timer values in decimal. 

D1SPC Displays counters in hex. 

LDiSPC Prints counters in hex. 

DISPV Displays variable values. 

LDISPV Prints variable values 

DISPX Displays numeric variables in hex. 
LDISPX Prints numeric variables in hex. 
DISPM Displays length (decimal) and contents 
of message buffer (hex). 

LDISPM Prints length (decim al) and contents of 
message buffer (hex). 

Print 

PRINT text Displays text on the screen. 

LPRINT text Outputs text to a printer. 

List Scenario 

LIST Displays the scenario in memory. 

LUST Prints the scenario in memory. 







SITREX COMMANDS 



Set Frame Level 

SFON Sets frame level ON. 

SFOF Sets frame level OFF. 


Set Packet Level 


SPON 

SPOF 

Set Link Level 
SLON 
SLOF 


Set packet level ON. 
Set packet level OFF. 

Sets Link ON. 

Sets Link OFF. 


Force Link On 
LNKUP 

Forces the Simulator to assume that the link has 
already been established. 

Transmit CRC 

SCRC+ Frames include good CRC. 

SCRC- Frames sent without CRC. 


Set Frame and Packet Window Size 
SKx 

x » frame window size, range 1 -7 
SUnW(R or T)x 

x » packet window size, range 1 - 7 
T » Transmit window size. 

R = Receive window size, 
n * pseudo-user number, range 1 - 7 

Set Frame and Packet State Variables 
SNS increments N(s). 

SNS— Decrements N(s). 

SNSx Sets N(s), range 0-7 

SNR+ Increments N(r). 

SNR- Decrements N(r). 

SNRx Sets N()r, range 0-7 

SUnPR+ Increments P(r). 

SUnPR- Decrements P(r). 

SUnPRx(xx) Sets P(r), range 0-7 (Mod 8); 
range 000-127 (Mod 128) 

SUnPS+ Increments P(s). 

SUnPS- Decrements P(s). 

SUnPSx(xx) Sets P(s), range 0-7 (Mod 8); 
range 000-127 (Mod 1 28) 

Set Data Packet Length 

SUnLTnnn Sets maximum length of 
transmitted data packet 

SUnLRnnn Sets maximum length of received 
data packet 

SGTh1h2 Sets the length of the data in the 
data packet sent by a traffic 
generator 


Set Primary/Secondary Address 
SPAh1h2 Sets Primary Address. 

SSAhl b2 Sets Secondary Address, 
hi h2 is the address. 

Set Logical Channel Group Number 
SLGhl 

hi * LCGN in hex 

Assigns a default LCGNfor the next placed call. 
Set Interface Leads 

Snnn+ Sets interface lead nnn active 
(space). 

Snnn- Sets interface lead nnn inactive 
(mark). 

nnn is one of the signal numbers: 


DCS 

106 

CTS 


107 

DSR 


109 

DCD 


122 

SDCD 


125 

Rl 

DTE 

105 

RTS 


108 

DTR 


Test Interface Leads 

Tests interface lead for mark or space and jumps 
to line number dddd if test is true. 

IFnnn+dddd Interface signal is active. 

IFnnn-dddd Interface signal inactive. 

Set Timers 

SThl h2h3h4 Sets timer T* 

ST”h1h2 Sets timer T” 

STUh1h2h3h4 Sets user-defined timer TU. 


Set Counters 

.SCnhl h2 Sets counter n to hex value hi h2. 
SCn+ Increments counter n. 

SCn— Decrements counter n. 

n is in the range 0-7. 

Set Pseudo-User Type 
Defines pseudo-users 3-7. 

Pseudo-user 1 is reserved for the trace page. 
Pseudo-user 2 is reserved for the Simulation page. 

SPUnA Pseudo-user is a Data Absorber. 
SPUnE Pseudo-user is an Echo Generator. 
SPUnT Pseudo-user as a T raffic Generator 

Set Up PVCS and SVCS 

SUnVPhl h2h3 Sets up a PVC. 

SUnVCh1h2h3 Sets up an SVC. 

n » pseudo-user number 
hi - LCGN 
h2h3 - LCN 




SITREX COMMANDS 


NUMERIC VARIA 

BLE COMMANDS 

Variable Operations 

SXAHh1h2 

Assigns a value to XA, in hex. 

SXA+XB 

Adds XA and XB and stores 


result in XA. 

SXA-XB 

Subtracts XB from XA and 


stores result in XA. 

SXA.XB 

Logical AND. 

SXA/XB 

Logical OR. 

SXA@XB 

Logical Exclusive OR (XOR). 

Shift and Rotate 


SXADn 

Shifts XA n times to ihe right. 

SXAGn 

Shifts XA n times to the left. 

SXARn 

Rotates XA n times to the right. 

SXALn 

Rotates n times to the left. 

n is in the range 1 to 7. \ 

Keyboard input 


S Scenario waits for the user to enter a two-digit hex 

value and then 

assigns, the value to a numeric 

variable 


INPUT XA 


Test Variables 


Tests variable using relational operators as shown 

below. If true, scenario jumps to line dddd. 

IXA=XB dddd 

XA equals XB 

)XAsh1h2 dddd 

XA equals hi h2. 

!XA#X8 dddd 

XA is not equal to XB. 

!XA#h1h2 dddd 

XA is not equai to hi h2. 

!XA<XB dddd 

XA is less than XB. 

IXA<h1h2 dddd 

XA is less than hi h2. 

!XA>XB dddd 

XA is greater than XB. 

IXA>h1h2 dddd 

XA is greater than hi h2. 

IXA(XB dddd 

XA <» to XB. 

!XA(h1h2 dddd 

XA <»to hi h2. 

IXAJXB dddd 

XA >*• XB. 

IXA)h1h2 dddd 

XA»h1h2. 




Assign Contents of Message Buffer 

SMHh...h 

Writes hex values into buffer, 
where h...h is up to of 128 hex 
digits. 

SMAa...a 

Writes ASCfl characters into 
buffer, where a... a is a maximum of 
64 ASCII bytes. 

SXAIXB 

inserts value of variable XA in the 
byte of the buffer indicated by the 
vaiue contained in variable XB, 

SXAlhl h2 

Inserts the value of XA in the byte 
of tiie buffer indicated by tile 
2-dig'rt hex vaiue hi h2. 

Message Buffer Length 

SXAI00 Message buffer length « XA. 

SXAOOO 

Extracts buffer length and stores it 
in XA. 


Byte Extraction 

SXAOXB Extracts byte at location indicated 
by X8 t and stores it in XA. 

SXAOht h2 Extracts byte at location indicated 
by the hex value hi h2, and stores 

itin XA. 

Test Message Buffer Contents 

Compares the contents of the 
message buffer to the byte and 
mask configuration in the 
command. 

ISXX/YY(,XX/YY}{ ) dddd 

dddd is the line number 

Transmit Message 

FM Transmits the frame, assigning the 

first byte of the message buffer (byte 
1) to the first byte of the frame. 

PM Assigns the contents of the message 

buffer, excluding the message buffer 
length (byte 0), to the L-Fteid of a 
frame (byte 3 and foiiowing) and 
transmits it 

PUn OS Assigns the contents of the m essage 

buffer (beginning with byte 1) to the 
data portion of the L-Field, and 
transmits it from the pseudo-user n. 


Display Trace 

TPRtNT All levels interpreted, data in hex. 
TPRINTA All levels interpreted, data in ASCII. 
TPRiNTF All levels uninterpreted, in hex. 
TPR1NTP Interpret frame-level. Wield in hex. 

Load Trace File 
TLOAD 


Print Trace 
LTPR1NT 
LTPRINTA 
LTPRINTF 
LTPRfNTP 


All levels interpreted, data in hex. 
All levels interpreted, data in ASCII, 
All levels unirrterpreted, in hex. 
Interpret frame-level. Wield in hex. 


Cat/o Trarfl 

TSAVE”0 filename" 
TSAVE" 1 filename" 


Save to the hard disk. 
Save to floppy disk. 


Set Trace On/Off 


STON 

STOP 

Clear Trace 
TRACE 


Sets the trace buffer ON. 
Sets trace buffer OFF. 


Trace Length 

Defines number of data bytes (0 - 255) displayed 
by the trace buffer. 

STRH1H2 

hi h2 is a hex value in the range 0 to FF. 







SITREX COMMANDS 








SITREX AUTOMATIC SIMULATOR COMMANDS 



FUNCTION 

pi 

Sets the Automatic X.25 Simulator to echo Called and Calling 
Addresses in Call Confirmation packets. 

pp 

Activates the Trace Buffer so that traffic is stored and displayed in the 
trace page. Once the trace is active, use CTRL P to make the trace 
idle. 

PS 

Enters programming mode and displays the ! prompt enabling you to 
enter Sitrex commands and write programs. From the ! prompt, you 
can exit Sitrex using the HALT command or exit program mode using 
the EXIT command. 


SITREX DEFAULT PSEUDO-USERS 




01 

Reserved for the Chameleon 32 Trace page (pink window). 

02 

Reserved for the Chameleon 32 Simulation page (blue window). 

03 

Traffic Generator 

04 

Echo Generator 

05 

Data Absorber 

06 

Second Traffic Generator 

07 

Third Traffic Generator 


SC 



























SITREX TRACE PAGE COMMANDS 

The table below lists the commands that control the display of traffic in the SITREX trace page. 


COMMAND 

FUNCTION 

0-9 

Modifies the scrolling speed. Fastest » 1 , Stop = 0 

A 

Toggles between ASCII and hex as format of displayed data. 

F 

Toggles display of frame level interpretation on/off. 

P 

Toggles display of packet level interpretation on/off. 

R 

Re-displays the contents of the trace. 

CTRL C 

Clears the trace memory. 

CTRL P 

Exits the trace mode and returns to the base Simulator level. 




















SITREX TRACE INTERPRETATION 


The example below show the interpretation of a S fTREX trace display. The first example interprets a display of 
a transmitted CALL packet. The second example interprets a transmitted DATA packet 


Transmitted 
Good CRC 
Frame Length 
Address 
1-Frame 
N(R) 

N(S) 


T* 019 01 I 1 1 /2007 CALL 1 234504 D 41 42 43 44 45 46 



T * 030 01 16 5 /E007 DA Q D 000 M 000 48 45 4C 4C 4F 20 46 52 




P{r) 

Mod 128 



SITREX ERROR CODES 


ERROR MEANING 

00 First character incorrect. 

04 Illegal Line number (valid range is 0 to 9999). 

1 5 Attempt to re-assign a new LCN to a previously set pseudo-user. 

16 Attempt to give a previously assigned LCN to a new pseudo user. 

18 RETURN without GOSUB. 

20 Incomplete Loop (; before * nn). 

21 Line number specified does not exist. 

22 Attempt to send a data packet on a logical channel that i not set up. 

26 Error in the call facility field of a call packet 

81-83 No space for scenarios (memory full). 

The message P followed by a two-digit code is Packet Error Coding from the Automatic X. 25 Simulator. 

POO Restart at the packet level. 

P01 Internal error. 

P02 Flow control anomaly (bad P(s) or P(r)). 

P03 Call or interrupt collision on a logical channel. 


TABLE ERROR 01,02 
TABLE ERROR 06,07 
TABLE ERROR 0A,0B 
TABLE ERROR 16 


Internal error. 

Internal error. 

Internal error. 

This error is associated with high density traffic. 


TOO Reception of a frame with an Wield that exceeds N 1 . 

T01 Address unknown, frame ignored (Not Primary or Secondary address). 

T02 Response with poll final bit set when not solicited. 

T03 Response with poll final bit not set when solicited. 

T04 Response unknown, results in sending CMDR. 

T05 Incorrect length of response frame, results in CMDR. 

T08 Received unsolicited UA. 

T09 Incorrect Nr received. 

T10 Reject frame received. 

Til RNR frame received. 

T14 Unknown command received. 

T1 5 Incorrect Ns received. 

T16 1-Frame out of sequence and station not busy and no Tx.RNR requested and no prior Tx.REJ OR 

Tx.P/F set. 

T1 7 i— frame out of sequence and station not busy and no Tx.RNR requested and no prior Tx.REJ and 

noTx.P/F set. 

T1 8 Received frame out of sequence with Tx.RR request. 

T19 Received frame out of sequence. 

T20 Internal error. 

T21 Error which occurs when SITREX sends a disconnect and the device under test gives an 

unexpected response. 

T22-24 Internal error. 



C SHELL COMMANDS 


man 

Displays the named help file, 
man filename 

mkdir 

Creates a subdirectory 
mkdir dirname 

mkres 

Makes a program RAM resident 
mkres [-p] prog 


-p Cannot be removed by memory 
manager 

more 

Displays file or pipe output one screen at a 
time 

more filename 

mv 

Moves a file 

mv filel file2 Replace file2 with filel 

mv file dir Move file to directory 

pwd 

Prints current subdirectory 
pwd 

rm 

Deletes one or more files 
rm filename filename... 

rmdir 

Deletes a subdirectory 
rmdir dirname 

rmres 

Removes a program from residency 
rmres ptd (pid-process ID) 

run 

Runs a program as a separate process. 
run{-xxx] <prog> & 


-xxx Priority in the range 1 - 230 

(230 * highest priority) 
progprogram filename 

setenv 

Sets an environment variable 
setenv name' value’ 
name: BC Background color 

FC Foreground color 

HOME Default cd path 
PATH Search path 
YEAR global-curr-year 
(or user-defined variable) 

shell 

Opens a new page with the C shell, 
shell & 

size 

Prints file size to standard output 
size filename filename... 

time 

Displays the system time, 
time 


& 

Runs program in background mode. 
progname & 

# 

Programmer's remark. 
mext 

* 

Echoes text to screen. 
'text 

batch 

Executes a batch file 
batch filename 

cat 

Concatenates and prints files 
cat filename 

cd 

Changes current directory 
cd path 

cp 

Copies files into a directory 
cp okffile newfile 

ctags 

Creates a file named fags that 
references the functions in the target C 
program files. The fag® file can then be 
used to locate functions while using the 
vi editor, 
ctags files 

dump 

Prints files in hex to standard output, 
dump filename filename... 

exit 

Exits C shell. Returns to main menu, 
exit 

format 

Formats a floppy cflsk. 
format 

getenv 

Displays environmental variable 
getenv name 


Name: BC Background color 

FC Foreground color 

HOME Default cd path 
PATH Search path 
YEAR globaF-curr-year 
(or user-defined variable) 

help 

Lists built-in shell commands 
help 

jobs 

Prints job control status 
jobs 

kill 

Kills a process that is running 
kill pid (ptd-process ID) 

Is 

Lists files 

Is [— d] [-kj [-IJ [-s] [spec] 


-d Sorted by date 

-k Sorted by file extension 

-1 Long list format 

-s Sorted by size 
spec Filename or path specification 






C SHELL REFERENCE 
















C LIBRARY FUNCTIONS (CONTINUED) 


Imaitoc Returns pointer to a biock of RAM of size 
or greater. Like malloc but accepts a long 
parameter, 
char *!mailoc(size) 
long size; 

longjmp Restores the environment saved by 
sstjmp in env. 

#ineiude<stdio.h» 

!ongjmp(env,vai) 
jmp-but env; 
int val; 

Ireaiioc RAM allocator which changes the size of 
the block pointed to by pir to size bytes. 
Like reaiioc, but accepts a long 
parameter. 

char ’ireallocfptr, size) 
char *ptr; 

unsigned long size; 

Iseek Moves the file pointer according to 
whence. 

long lseek(fildes, offset, whence) 
int fildes; 
long offset; 

int whence ; 0 » Set to offset 

1 » Curr. position+offeef 

2 ■ File size + offset 

malloc Returns pointer to a block of RAM (64K 
bytes or less) of size or greater, 
char *malloc(size} 
unsigned Int size; 

open Opens a file described for fname and sets 
flag to oflag. 

#include <fnctl.h> 
int open(fname,oflag) 
char *fname; 

int oflag; O-RDONLY Read only 
O-WRONLY Write only 
O-RDWR Read/write 
O— BINARY Binary mode 

perror Writes an error mesage onto the standard 
stream. 
perror(s) 
char *s; 

extern int sys_nerr; 
extern char *sys_erriistQ; 
printf Places output on stdout. 
include <stdio.h> 
int printf(formatf,argl._) 
char ’format; 

putc Writes character c to the output stream at 
current pointer position. 
#inciude<stdio.h» 
int putc (c,stream) 
char c; 

RLE ’stream; 

putchar Equivalent to putc(c, stdout). 
#include<stdio.h> 
int putchar(c) 
char c; 


puts 

Writes the string pointed to by s to 
stdout. 

#inc!ude <stdio.h> 
int puts{s) 
char *s; 

putw 

Writes the word (integer) w to the output 
stream at current pointer position. 
#inc!ude <stdio.h> 
int putw (w, stream) 
int w; 

FILE ’stream; 

Quick sort algorithm. 

qsort(base, nelem, width, compare) 

char ’base; 

int nelem, width; 

int (’compare) (); 

qsort 

rand 

Generates a random number. 


#include <stdio.h> 
int rand() 

read 

Reads nbyte bytes from the file into the 

buffer pointed to by buf. 

int read(fildes,buf, nbyte) 

int fildes; 

char *buf; 

unsigned int nbyte; 

reatloc 

RAM allocator which changes the size of 
the biock pointed to by ptrto size bytes, 
char ’rea!!oc(ptr, size) 
char *ptr; 
unsigned int size; 

Renames a file on disk, 
int rename (from, to) 
char ’from, ’to; 

rename 

rewind 

Equivalent to fseek(stream,OK,0), but no 
value is returned. 

#inciude <stdio.ft> 
rewind(stream) 

FiLE ’stream; 

scanf 

Reads from stdin and converts formatted 
input 

#include <stdio.h> 

int scanf(format[, pointer]...) 

char ’format; 

setbuf 

Assigns buffer pointed to by a to a 
stream. 

#inciude <stdio.h> 
setbuf(stream,buf) 

FILE ’stream; 
char *buf; 

sstjmp 

Non-local goto which saves its stack 
environment in env for use by longjmp. 
#inciude <stdio.h> 
int setjmp(env) 
jmp-buf env; 







C LIBRARY FUNCTIONS (CONTINUED) 








C LIBRARY FUNCTIONS (CONTINUED) 



assignieds Creates or changes LEDs. 

assignLeds(vtnum, pleds, ledword) 
long vtnum; Virtual terminal no. 

long pleds; Points to 80 chars, 

long ledword; Bits 0 — 9: If Bit l — 1 , 
LED i+1 is on. It Bit i 
» 0 LED i+1 is off. 

Bits 10-31 reserved. 

closeform Changes from form to window mode. 
closeform{vtnum) 

long vtnum; 

closevt Releases the virtual terminal. 

c!osevt( vtnum) 

long vtnum; Virtual terminal no. 

disablecur Causes the cursor to be invisible 
disablecur( vtnum) 
long vtnum; Virtual terminal no. 

enablecur Causes the cursor to be visible 
enablecur( vtnum ) 

long vtnum; Virtual terminal no. 

getch Gets a character from stdin. 

char getch(vtnum) 
long vtnum; 

getcwt Waits for a character from stdin. 
char getcwt(vtnum) 

long vtnum; 

openform Opens a form. 

long openform() 

openvt Assigns a virtual terminal, 

long openvt(pname) 
char pname; 23-character string 

prndata Sends data to the printer. 

prndata(data) 
char ’data; 

putvt Displays a string on a virtual terminal. 

putvt(vtnum, 'string ’) 
long vtnum; Virtual terminal no. 
char 'string; Maximum of 80 ASCI! 

characters, VT10Q 
format 

selprn Selects the parameters for a printer, 
selprn {device, br, bits, sb , par) 
long device, br, bits, sb, par; 

Default: Parallel, 9600, 8, 2, Even 
device 0-Serial bits 0-5 bits 

1 -Parallel 2-6 

br 3=300 1-7 

6=600 3-8 

12-1200 sb 1-1 stop bits 

24-2400 2-1. S 

48=4800 3-2 

96-9600 par 0-None 

192-19200 1-Odd 

3-Even 


#indude <math.h> 

double x,y; 
int a, k; 


log(x) 

Base e logarithm, 
double log(x) 

Iog10(x) 

Base IQ logarithm, 
double Iog10(x) 

iog2(x); 

Base 2 logarithm, 
double log2(x) 

exp(x) 

Base e exponential, 
double exp(x) 

exp10(x) 

Base 10 exponential, 
double explO(x) 

exp2(x) 

Base 2 exponential. 

sin(x) 

double exp2(x) 
Transcendental functions. 


double sin(x) 

cos(x) 

double cos(x) 

tan(x) 

double tan(x) 

asin(x) 

Inverse transcendental functions, 
double asin(x) 

acos(x) 

double acos(x) 

atan(x) 

double atan(x) 

sqr(x) 

double sqr(x) 

sqrt(x) double sort(x) 

powerd(x, y) xy (equiva ent to exp2(x’log2{y)) 


double powerdfx, y) 

powerifx,a) xa (equivalent to exp2(x*!og2(a)) 


double poweri(x,a) 

dabs(x) 

Absolute value (?x?). 
double dabs(x) 

dint (x) 

Integer part of the double that is the 

parameter. 

int dint (x) 

mulpower2(x, k) Fast floating point multi plication 


by 2k. 

double mulpower2(x, k) 

Ingamma(x) Natural logarrthym of the gamma 


function if 0<x<5.1 XI 0305. 
double Ingamma(x) 

fac(k) 

ki, where G?k?170 
double fac(k) 

Matrix 

double matinv(a,c,n) 
double *a; 


long *c; 


long n; 


Fmkdir 

Creates a directory. 
#inciude <msfsuse.h> 


Fmkdir(dirname) 

char ‘dirname; (including path) 

Frmdir 

Removes a directory. 
#inciude <rnsfsuse.h> 


Frmdir(dirname) 

char ‘dirname; (including path) 

Fsearch 

Searches for a file or directory. 
#inc!ude <msfsuse.h> 


Fsearch(name, option, rec) 
char ‘name; (file/dir name and path) 
int option; (0=first occ, 1 = next occ) 
struct DREC *rec 


__ee 






K EL 


vi COMMANDS 


n Number 
Opt Option 
A CTRL key 


X Single upper or lower case character 

CR RETURN key (carriage return) 

pat Text and/or pattern matching characters 


INPUT COMMANDS 


a 

Append after cursor. 

A 

i 

i 

Append at end of line. 

Insert before cursor. 

Insert before first non-blank. 

0 

Open and insert at line below. 

0 

Open and insert at line above. 

A D 

Backtab over autoindent. 

0 A D 

Kill all autoindent. 

A V 

Insert a non-printing character. 

DELETE COMMANDS 

X 

Delete character. 

nx 

Delete n characters. 

X 

Delete character before cursor. 

dw 

Delete word. 

ndw 

Delete n words. 

dd 

Delete line. 

odd 

Delete n lines. 

dtx 

Delete to x in a line. 

D 

Delete rest of line. 

dlpatCH 

Delete up to pat 

d?patCR 

Delete back to pat 


A W 

Erase last word. 

A H 

Erase last character. 

ERASE 

Keyboard character (same as A H) 

kill 

Keyboard character. Kill input on 
current line. 

ESC 

Keyboard character. End insert 
mode.. 

MARKING COMMANDS 

mx 

Mark position with letter x. 

’x 

Return to mark x. 

'x 

Mark at first non-blank in line. 


CHANGE COMMANDS 


cw 

Change word until ESC. 

DON 

Change n words until ESC. 

CC 

Change line until ESC. 

ncc 

Change n lines until ESC. 

cXx 

Change to x until ESC. 

C 

Change rest of line until ESC. 

d patCR 

Change up to pat. 

c?pafCR 

Change back to pat 



G 

Go to last line of file. 

nG 

Go to fine n. 

/pat 

Go to next line matching pat 

7 pat 

Go to previous line matching pat 

n 

Go to next / or ?. 

N 

Go to previous / or ?. 

Ipat/+n 

Go to nth line after pat 

?pat?-n 

Go to nth line before pat 

n 

Go to previous context 

n 

Go to first non-blank in line. 

INVOKE. EXIT. SAVE COMMANDS 

vi file 

Edit first line of file. 

ZZ 

Exit vi and save changes. 

w 

Write (save) changes. 

file 

Write (copy) to file. 

:q 

Quit vi. 

:wq 

Write (save) changes and quit vi. 

:q! 

Quit vi without saving changes. 

MODIFY COMMANDS 

« 

Repeat last operation. 

- 

Reverse case of letter. 

J 

Join lines. 

« 

Shift line left 1 tab. 

» 

Shift fine right 1 tab. 










vi COMMANDS (CONTINUED) 


4- or j 
f ork 
-»orl 
«-orh 


A L 

A R 

zCR 

z. 

z- 

Ipatlz- 

zn. 

A E 

A Y 

A F 

A B 

A D 

A U 


[A-Z\ 

[adc] 

[ A a£>q| 


stext 

S 

:siXIY/opt 


:g/X/s//Y/opt 


Move to 1st character, next line. 
Move to 1 st char, previous line. 
Move to next line, same column. 
Move to previous line. 

Move to tiie right. 

Move to the left. 

Move to end of line. 


Clear and redraw screen. 
Retype, without deleted lines. 
Redraw, current line at top. 
Redraw, current line at center. 
Redraw, current Tine at bottom. 
Redraw with pat line at bottom. 
Redraw window with n lines. 
Scroll window down 1 line. 
Scroll window up 1 line. 

Scroll forward 1 screen. 

Scroll backward 1 screen. 
Scroll down half a screen. 
Scroll up half a screen. 


Beginning of line. 

End of line. 

Any character. 

0 or more repetitions of character. 
Match any character from A -Z 
Match a, h or c. 

Match any char, except a, b,c. 
Escape character for literal \ / $ . 
A t’&*| - 
Beginning of word. 

End of word. 


Substitute text for character. 
Substitute line. 

Substitute first X with Y. 
opt g Change ail 
occurrences 

c Confirm each change, 
p Print each change. 
Repeat last :s request 


UNDO COMft 
U 

IANDS 

Undo last operation. 

U 

Restore current line. 

“np 

Retrieve nth last delete. 

“rrl pu.u.u. 

Scan previous n deletes. 


Globally substitute Y for X 
for first X on each line. 




yy or Y 
nyy or nY 

P 

P 

*xy 

“*P 


Move forward 1 word. 

Move forward 1 word, including 
punctuation. 

Move back 1 word. 

Move back 1 word, including 
punctuation. 

Move to end of word. 

Move to end of word, including 
punctuation. 

Find x forward (to the right). 
Repeat last f. 

Reverse last f. 


Yank line to buffer. 

Yank n lines to buffer. 

Put lines back below cursor. 
Put lines back above cursor. 
Yank to buffer x 
Put from buffer x. 


FILE Softkeys 


FI 

Open 

a 

FS 

Read 

7 

F2 

Save 

IW 

F7 

Set 

set 

F3 

Quit 

:q 

F8 

Next 

m 

F4 

Sav/Qit 

ZZ 

F9 

Rewind 

:rew 

F5 Revert :el 

EDIT Softkeys 

F10 

EDIT Softkeys 

FI 

Insert 

i 

F6 

Paste 

P 

F2 

Append 

a 

F7 

Srch Fw 

/ 

F3 

Del chr 

X 

F8 

Srch Bk 

? 

F4 

Cut 

Y 

F9 

Again 


F5 

Copy 

Yp 

F10 

RLE Softkeys 






C PROTOCOL LIBRARY COMMON FUNCTIONS 


These functions are available in all protocol libraries. 

FLUSH Clears all outstanding frames in the 
reception buffer, 
int flush() 

Returns: 3 Receive buffer overflow 

GETPHY Indicates physical interface setting, 
int getphy() 

Returns 2— byte integer as shown below. 

Byte QBit 7 654321 0 

Pin 105 108 140 141 104 103 114 115 

Pin 4 20 3 2 15 17 

Sig RTS DTR SQ RD TD SCT SCR 

Byte ISit 7 654321 0 

Pin 106 107 109 122 125 142 

Pin 5 6 8 12 22 

Sig CTS DSR CD SDCD RI 

GETPORT Identifies which port is communicating 
with the library, 
int getportO 

Returns: O- Port A selected 

1 -Port B selected 

GETJME Gets the number of milliseconds since 
the system was started. 

#inciude <mtos -ux.h> 
int getime(msbfr) 
unsigned char 'msbfr; 

INITT1ME Initializes the .01 and 1 second timers. 

Use initpf to initialize the port before 
you use inittime. 
int inittimeO 

PI RESET Restarts or resets the Front End 
Processor. Restart clears the 
reception buffer. Stop is similar to a 
hardware reset, 
int pi reset(kind) 

int kind; 0 Restart simulation 
1 Stop simulation 

SETLEDS Controls which port’s LEDs are 

displayed on the front panel of a Dual 
Port machine, 
int setledsfpori) 

int port; 0-Port A LEDS displayed 
1 -Port 8 LEDS displayed 
Returns 0 -Successful 

1 -Invalid parameter 
2-Not a Dual Port machine 
SETPHY Sets physical interface lines as below. 
setphyQ 


DCEBit 7 

6 

5 

4 

3 

2 10 

Pin 106 

107 

109 

122 

125 

142 

Pin 5 

6 

8 

12 

22 


Sig CTS 

DSR 

CD 

SDCD 

RZ 



SETPHY (continued) 

DTEBit 7654 3210 

Pin 105 108 140 141 

Pin 4 20 

Sig RTS DTR SQ 


SETPORT Selects Port A or Port B for library, 
int setport(port) 
int port; 0-Port A 
1=Port B 
Returns 0-Successful 

—1 -Parameter out of range 
-2-Port B not available 

SETT1MER Sets the timer value, 

settimer {number, value) 
char number, 0-.01 timer (down) 

1 —.01 timer (up) 

2- seconds (down) 

3- seconds (up) 

unsigned int value; timer setting 
Returns: 0=Successfui 

1 -Invalid number 
2-inittime not performed 

TIMER Returns the value of the timer, 
int timer {number) 
unsigned int number; 

Q-.01 (down) 

1=.01 (up) 

2=seconds (down) 
3=seconds (up) 

GLOBAL ERROR CODES 

—1 Front End Processor (FEP) is busy 

0 FEP is free 

1 FEP is transmitting 

-200 Port is busy 

-201 FEP parameter 

-201 FEP Parameter port 

-202 Not valid on ISDN interface 

-208 Code not found 

-209 FEP cannot be started 

-21 0 Application Invalid 

-211 Invalid transmission mode 

-212 Timeout 

-21 3 No memory available 

-214 FEP Code read 

-21 5 FEP file not found 

-21 6 FEP Code not loaded 

-217 FEP halted 

-218 No PortB 

-21 9 Internal running 

-220 FEP Load error 

-222 Undefined status 

-224 FEP Data not set 
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BOP C LIBRARY FUNCTIONS 


BOP LIBRARY FILENAME; libbop.a 

DISCARD Discards a frame prior to its entering a 
buffer. 

in it discard{ ) 

Returns: 

0 Frame discarded; no frame in 
buffer. 

<0 standard error codes 

INITP1 Initializes Pi , Loads simulation software. 

When initialized with this function, the 
maximum frame size handled by the 
simulator is 2 kbytes, 
int initpl {type, encode, bitrate, flag ) 
int type; Q=DCE 

1- OTE 

2- ISDN 

int encode; 0*»NRZ 

1-NRZI 

unsigned long bitrate; 50 - 64000 
int flag; 0-FF 

1-7E 

Returns: 

G«Successful 
-1 -invalid parameter(s) 

-2»P1 program not loaded 

GET_NXLEN Returns the length of next frame from 
FEP. 

irrt get nxlen () 

Returns: 

0 ■ No new frame 

>0 » length of next frame 

<0 * Standard error codes. 

GET_NXSTAT Gives status of next frame, 
int get_nxstat ( ) 

Returns: 

0 No new frame 

1 Frame ok 

2 Parity error in frame 

3 Abort sequence in frame 
<0 Standard error codes. 


!NITP1_8K Initializes Pi . Loads simulation 

software. When initialized with 
this function, the maximum frame 
size handled by the simulator is 8 
kbytes. Monitoring applications 
cannot be run simultaneously 
when initialized with this function. 


int initp_8k1 (type, encode, 

bitrate, flag) 

int type; 0-DCE 

1- DTE 

2- ISDN 
int encode; Q-NRZ 

1-NRZ! 

unsigned long bitrate; 50 - 64000 
int flag;0=FF 
1 =7E 

Returns: 

0=Successful 
-1 =lnvalid parameter(s) 

-2=P1 program not loaded 

RECEIVE Receives a frame from Pi and places it 
at address in frame. 
char receive (frame) 
char 'frame; 

Returns: 

OwGood CRC or no frame waiting 

1 - Bad CRC 

2- in'rtpl not performed 

3=Overflow 

4-Abort frame received 

SETFLG Changes the idle fill pattern, 
int setflg(f/ag) 
char flag; 0-FF 


TRANSMIT Transmits number of bytes in length, 
starting at address in frame. 
int transmrt(mode, frame, length) 
int mode; 0=Good CRC 
1=Bad CRC 
2=Abort sequence 
char 'frame; 
int length ; 

Returns: 

0- Successful 

1- PI busy 

2- initpl not perfoimed 

3- Parameter error 

4- Buffer overflow 

TREADY Returns status of PI transmitter, 
int tready() 

Returns: 

0- Transmitter ready 

1- Transmitter not ready 

2- initpl not performed 

3»Overflow 






LAPD C LIBRARY FUNCTIONS 


LAPP LIBRARY FILENAME: libiapd.a 
GET_MOD Returns the current modulus, 
int get jmod() 

Returns: 

Q-ModS 
1 -Modi 28 

GET_RNTEI Returns value of user-defined receive 
TEL 

int get_rntei(val) 
int vai; Range: 0-2 

Returns: 

0—127® TEi value 

-1 ® vai outside of range 
-2® No extended memory 

GET_RSAP1 Returns value of user-defined SAPI. 
int get_rsapi(val) 
int vai; Range: 0-2 

Returns: 

0 — 63® SAPI value 

-1 m vai outside of range 
-2* No extended memory 

GET_SCONFIG Returns status configuration byte, 
int get_sconfig 

Returns status configuration byte 
(see manual for interpretation). 

GET_SIM Returns the side being simulated, 
int get_sim() 

Returns: 

0-Network 
1 -Subscriber 

1NITP1 Initializes PI and loads software. 

int m/fptfinterface .station, encode, bit ratej 
int interface; Q-DCE 

1- OTE 

2- ISDN 

int station; 0-Network 
1 -Subscriber 
int encode; 0-NRZ 
1-NRZI 

long titrate; 50 - 64000 
Returns: 

0-Successful 
-1 -Parameter error 
-4-Code not found (see manual) 

-3-Time out 

-4-Can't set interface mode 
— 5-Can’t set Vtype interface module 
-6-Can’t set bit rate 
-7-lnternai error 
-8-Can’t run FEP 
-1 0-Can't restart simulator 
-11 -Can’t initialize simulator 
-1 3 -Can’t initialize timers 


RECEIVE Receives an Wrame from PI and places 
it at address in rioc. 
extern int rxlen 
int tecewe(rloc) 
char * rioc ; 

Returns: 

0-Successful or no frame waiting 
2minrtp1 not performed 
4=>P1 busy 


RESTARTSIM Restarts PI simulation, 
int restartsim() 

Returns: 

0-Successfui 
t -Tim© out 

SETFLG Changes the idle fill pattern, 
int setflg(flag) 
int flag; 0 Fill with FF 

1 Fill with 7E 

Returns: 0 Successful 

1 Timeout 

SET _ BIT R ATESets the bit rate. 

int set_bit_rate(rate) 

long rate; Range: 50-64000 

Returns: 

0- Successful 

1 - Error 

SET_MOD Sets the modulus to mods or 
modi 28 

int set_mod{ vai} 
int vai; 0=Mod8 
1 -Modi 28 

Returns: 

0-Successful 
-Imval outside of range 
1 -Time out 

S N200 Sets N2 (retransmissions), 
int s_n200(vai) 
int vai; 

Returns: 

0- Successful 

1- Time out 

S_N201 Sets N1 (maximum packet size), 
int s_n20l(vai) 
int vai; Range: 1-512 
Returns: 

0- Successful 
-1-va/ outside of range 

1- Time out 





LAPD C LIBRARY FUNCTIONS - CONTINUED 


SET_NET Sets simulation of network, 
int sat_net{) 

Returns: 

0- Successful 

1 - Time out 

SET_RNTE! Sets user-defined TEI value, 
int set_rntei( vai, tei) 
int vai; Range 0-2 

int tei; Range 0 - 255 

Returns: 

0=Successful 
1-Time out 

—1 =vai or tei outside of range 
-2=No extended memory 

SET_RSAP1 Sets value of user-defined SAPI. 
int set_rsapi(va/, sapi ) 
int vai; Range 0-2 

irrt sapi; Range 0—63 

Returns: 

0-Successful 
1 -Time Out 

-1-va/ts outside range 
-2-No extended memory 

SET SAPI Sets supported SAPI for transmission 
irrt set_sapi(va/) 
int vai; 0-63 
Returns: 

©-■Successful 
-1-va/ outside or range 
1 -Time out 

SET_SC0NF1G 

Sets status configuration byte. 

intset_sconfig(byte) 

irrt byte; 

Returns: 

0-Successful 
1 -Time Out 

-2-No extended memory 


S_T200 Sets value of the T200 timer. 

int setjl(vaf) or s_t200(val) 

int vai; 

Returns: 

©•-Successful 
1 -Time out 

S_T203 Sets value of T2 timer. 

int set_t2( vai) or s_t203(val) 

int val; 

Returns: 

0-Successful 
1 -Time out 

SET_TE1 Sets the transmit TEI value, 
int satjei(vaf) 
int vai; Range: 0-127 
Returns: 

0- Successful 

— 1-va I outside or range 

1- Time out 

SET_WINDOW 

Sets window size, 
int set_window( vat) 

int vai; Range: 1-7 

Returns: 

©-Successful 
-1-va/ outside of range 
1-Time out 

SLOF Disconnects link, 

int slofQ 
Returns: 

0- Successful 

1- Time out 

SLON Establishes fink by sending a SABM or 

SABME. 
int sion() 

Returns: 

0- Successful 

1- Time out 


SET_SU8 Sets simulation of subscriber, 
int set_sub() 

Returns: 

0-Successful 
1 -Time out 





LAPD C LIBRARY FUNCTIONS - CONTINUED 


STATUS indicates status of frame level, 
int status() 

Returns; 

□-■"Disconnected 
1 -Link connection requested 
2=Packet reject 

3 -Link disconnection requested 
"^Information transfer 

5- Local station busy 

6- Remote station busy 

7- Local and remote station busy 
“8-Remote station not responding 
other-LAPD not running 

STOPSIM Stops Pi simulation, 
int stopsimQ 
Returns; 

0- Successful 
1 -Time out 

TRANS Transmits a specified type of frame. 
int fransfstat, frame, len) 
int stef; Ox80=»i-Frame 
0x81 — Ui frame 
Qx82-XID Command frame 
0x83- XSD Response frame 
char ‘frame; 
int Sen; (0 — 511) 

Returns: 

©—Successful 

1- PI busy 

2- inrtpf not performed 

3- Link not established 
5-Time out 

trxcni if an XI D command with 
/en»Q 

trxmi if an XID response with 
fen- 0 

TRANSMITTransmits number of bytes in length, 
starting at address in packet 
int transniitfpac/ret length) 
char * packet ; 
int length; 

Calls and returns the value returned by; 
transf IFRAM E, packet, length) 


TRUI Transmits an unnumbered Wrame. 

int trui(xfoc,x/en) 
char * xloc ; Location of data 

int x/en; Length of data field 
Calls and returns the value returned 
by; trans(Ui, packet, length) 

TRXCNI Transmits an XID command frame 

without an Wield, 
int trxcni() 

Returns: 

O-Successfui 
1 -Time out 

TRXIDC Transmits an XID command frame 
with an Wield, 
trxidc (xtocpc/en) 

char 'xloc; Location in memory 
int x/en; Length 

Calls and returns the value returned 
by: trans(XIDC,xloc,xlen) 

TRXIDR Transmits an XID response frame 
with an Wield. 
trxidr(x/cc,x/en) 

char 'xloc; Location in memory 
int xlen; Length 

Calls and returns the value returned 
by: trans(XlDR,xioc,xien) 

TRXRNI Transmits an XID response frame 
without an Wield, 
int trxmiO 
Returns: 

0- Successful 

1- Time out 








SDLC C LIBRARY FUNCTIONS 


SDLC LIBRARY FILENAME: libsdlc.a 
1NITP1 Initializes PI and loads software. 

int initpl ( type 1, typeZ encode,bitra te) 
int typel; 0-DCE 
1=DTE 
2=1SDN 

int type2; 0=Primary 

1=Secondary 
int encode; Q-NRZ 
1 =NR21 

unsigned long titrate; 50 - 64000 
Returns: 

G-Successful 
-1 -Invalid parameters) 

-2=P1 program not loaded 


RECEIVE Receives a frame from PI and places it 
at address in packet 
char receive ( packet) 
char * packet; 

Returns: 

O-Successful 
1 -Link not established 

2-in'rtpl not performed 

SET_ADR Sets transmit and receive address 
int set_adr( vat) 
char vai; Range : 0 - 255 
Returns: 

O-Successful 

-1 -Parameter error 

SET_N2 Sets N2 (number of retransmissions), 
int set_n2(va/) 
int vai; Range: 1 - 255 
Returns: 

O-Successful 
— 1 - vai outside of range 
5**Not a primary station 


S£T_T1 Sets T1 timer. 

int setjl(vai) 

int vai; Range: 1 - 255 

Returns: 

O-Successful 
-1 - va/ outside of range 
5-Not a primary station 


SET_T2 Sets T2 frame level timer, 
int set_t2(vai) 
int vai; Range: 0 - 255 
Returns: 

0— Successful 
-1 -vai outside of range 


SLOF Disconnects link, 

int slof() 

Returns: 

5-Not a primary station 

SLON Establishes link by sending a SABM. 

int slon() 

Returns: 

5=Not a primary station 

STATUS Indicates status of frame level, 
int status() 

Chameleon 32 as Primary returns: 
Q=Normal disconnected mode 
1 -Unk request state 

2- Disconnect request state 

3- Information Transfer state 

4- Local station busy 

5- Remote station busy 

6- Local & remote stations busy 

Chameleon 32 as Secondary returns: 
0-Normai disconnected mode 
1 -Initialization mode 

2- Frame reject 

3- Information Transfer 

4- Local station busy 

5- Remote station busy 

6- Local & remote stations busy 

TRANSMIT Transmits Wrame with I— field of length, 
starting at address in packet 
int transmit(pactet length) 
char * packet ; 
int length; 

Returns: 

0- Successful 

1- PI busy 

2=initpt not performed 

3- Link not established 

4- Length error (if length > 51 0) 

TRNSI Transmits a non-sequenced Wrame with 
Wield of length, starting at address in 
packet 

int trnsr (packet, length) 
char * packet ; 
int length; 

Returns: 

0- Successful 

1- PI busy 

2- initpl not performed 

3- Link not established 

4- Length error (if length > 510) 


5-Not a primary station 




SDLC C LIBRARY FUNCTIONS - CONTINUED 


TRSIFR Transmits a sequenced (-frame with 


TRUl Transmits an unnumbered Mrame with 

Mield of length, starting at address in 


(-field of length, starting at address in 

packet 


packet 

int trsifrfpackef, length) 


int trui (packet, length ) 

char ’ packet ; 


char * packet ; 

.int length; 


int length; 

Returns: 


Returns: 

O-Successful 


O-Successful 

1-PI busy 


1 -PI busy 

2-initpl not performed 


2=initp1 not performed 

3-Link not established 


3-Link not established 

4-Length error (if length >510) 


4-Length error (if length > 510) 

TRTST Transmits a test frame with (-field of 


XID Transmits an XID frame containing the 

length, starting at address in packet 


data in the externally available character 

int trtst (packet, length ) 


array identf ]. 

char * packet ; 


extern char identf ]; /* 6 bytes */ 

int length; 


char xid{); 

Returns: 


Returns: 

Q»Successfui 


0«Successful 

1-PI busy 


1-PI not initialized 

2*initp1 not performed 


2-Pi fails to respond 

3-Link not established 


3-Not in normal response mode 

4-iliegaf frame (if secondary) 


4=lilegal frame (if secondary) 

5=Not a primary station 










BASIC RATE INTERFACE LIBRARY FUNCTIONS 


FILENAME: libbri.a 



SetBasic int SetBasic(cmdblock, resblock); 


int cmdblock [5]; 
int resblock [5]; 


The error codes for resbiock[0] for all Basic Rate Library commands and are listed below. 

resblock [0] Meaning 


00 

Successful 


01 

Hardware has already been set up 

02 

Requested function is not available for this configuration 

03 

Requested channel is invalid (for B1 , B2 and D) 

04 

Requested function is not available for this channel 

05 

Invalid command or request 

10 

Basic Rate interface board is not installed 

Setup 

cmdblockfO] a 1 {Board 0) 

or cmdblock{0] =» 101 (Board 1 ) 


cmdblockfl } mode 1 

Monitor 


2 

Simulate NT 


3 

Simulate TE 


resblock[1 J Returns current mode, if unsuccessful 

Reactivate 

cmdblockfO] a 2 (Board 0) or cmdblock[0] «■ 102 {Board 1 ) 


Argument None 


Reset 

cmdblock{0] « 3 (Board 0) 
Argument None 

or cmdbtock{0] * 103 (Board 1) 

Channel 

cmdblock(Q] * 4 (Board 0) or cmdbiockTOJ » 1 04 (Board 1 ) 

Functions 

cmdblock{1 ] mode 0 

If request conflicts with current setup, do not override. 


1 

If request conflicts with current setup, override. 


cmdblock(2] channel 

1 B1 channel 

2 82 channel 

3 D channel 


cmdbfock{3] selection 

1 System 

2 Milliwatt 



3 Codec 

4 External interface 

5 Idle 


resblockfl ] channel as defined above (If resblock[0] 0) 

resblock(2] selection as defined above ( If resblock[0] 0) 

Signal 



Functions 

cmdblock(0] a 5 (Board 0) 

or cmdbiockfO] - 105 (Board 1 ) 


cmdblockfl ] For NT 1 

Deactivate request 


2 

Send info-2 


3 

Send info-4 


4 

Activate NT 


5 

Reserved 


6 

Send single pulses 


7 

Send continuous pulses 


8 

Send info-2, test loop 2 


9 

Send info-4, test loop 2 


For TE 1 

Deactivate 


2 

Activate at priority 8 


3 

Activate at priority 1 0 


4 

Activate TE 


5 

Reserved 


6 

Reserved 


7 

Reset PEB 2080 


8 

Send single pulses 


9 

Send continuous pulses 


10 

Activate test loop 3 




BASIC RATE INTERFACE LIBRARY FUNCTIONS - CONTINUED 


Get Status 

cmdbiockfO] * 6 (Board 0} or cmd block [0] » 106 (Board 1) 


Argument None 



resblockfl] Control byte received from PEB 2080. 
resbiock(21 (If Simulating an NT): 


1 

No dock signal 


2 

Lost signal level 


3 

Receiver not synchronous 


4 

Error 


5 

Info-1 received 


6 

Receiver synchronized 


7 

Deacitvation complete 


8 

Undefined 


resbiock(2] (If Simulating a TE): 


1 

Power up 


2 

Deactivate request 


3 

Slip detected 


4 

Disconnected 


5 

Error 


6 

Resynchronizing 


7 

lrrfo-2 received 


8 

Test mode 


9 

Level received during test loop 


10 

Info-4 received, D channel priority 8 or 9 


11 

Info-4 received, D channel priority 10 or 11 


12 

Quiescent state 


13 

Undefined 


If in Monitor mode: 



resblock[1] Control byte received from PEB 2080. 
resblock{2] Same as resbiock{21 from NT 


resblock[3] Same as 

resblock[2] from TE 

Select Trace 



Option 

cmdbiockfO] » 9 (Board 0 only) j 


cmdblockfl] 0 

Turns off the trace 


1 

Command/resuit display 


2 

Detailed trace 

NT Power 

cmdbiockfO] » 1 0 
cmdbfockfl] mode 

1 Power source 1 (normal conditions) 

2 Power source 1 (emergency conditions) 

3 Power source 2 (normal conditions) 

4 Power source 2 (emergency conditions) 

5 Off 

Bas version 

This function returns the current version of the BRI library. 


char *Bas_version() 



-7 ft- 





FILENAME: libu.a 

SetU int SetU (cmdblock, resblock); 

char cmdblock [ ]; 
char resblock [ J; 

The error codes for resblock [0] for all ^-Interface Library commands are listed below, 
resblock [0| Meaning 

00 Successful 

01 Invalid command 

02 Invalid command parameters 

03 Requested board is not responding 

04 U— board physical error 

05 U-board interface is not initialized 

06 Requested board is not installed 

Initialize cmdblockfl] = 0 (Board 0) or cmdblock [1] = 100 (Board 1) 

Configure cmdblockfO] = 1 (Board 0) or cmdblock [0] = 101 (Board 1) 

cmdbiockfl] mode 1 Monitor 

2 Simulate NT 

3 Simulate TE 

resblock[1 ] Returns current mode, if unsuccessful 

Set 

Transceiver 

State cmdblock[0J = 2 (Board 0) or cmdblock[0] = 102 (Board 1) 

cmdbiock[1] = Xcvr specifier 0 = NTXcvr 

1 « LT Xcvr 

cmdblock(2] = Xcvr State 1 = Reset 

2 = Power down 

3 = Absolute 

4 = Normal 

Get 

Transceiver 

State cmdblock(0] = 3 (Board 0) or cmdblock{0] = 103 (Board 1) 

cmdblockflj * Xcvr specifier 0 = NTXcvr 

1 = LT Xcvr 

cmdb!ock[2] = Xcvr State 1 = Reset 

2 = Power down 

3 = Absolute 

4 = NormalSet 

Transceiver 

Activation cmdbiock[0] = 4 (Board 0} or cmdblock(0j = 104 (Board 1} 

cmdblockfl] = Xcvr specifier 0 = NTXcvr 

1 = LT Xcvr 

cmdb!ock{2] = Xcvr State 1 = Start activation 

2 s» Start deactivation 

Get 

Transceiver 

Connection cmdblockfO] = 5 (Board 0) or cmdbiock[0] = 105 (Board 1) 

cmdbiock[1} = Xcvr specifier 0 = NTXcvr 

1 = LT Xcvr 

resblock(0] = See Error Code 
resbiockfl] = Xcvr Connection 0 = None 

1 = Port A 

2 = Port B 

3 = Ports A and B 
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2B1Q U-INTERFACE C LIBRARY FUNCTIONS (continued) 


Set 

Transceiver 

Errors 

cmdbiock[0] = 

6 (Board 0) or cmdblockfO] = 106 (Board t) 


cmdblockfl] = 

Xcvr specifier 0 == NT Xcvr 
1 = LT Xcvr 

Get Transceiver 


Errors 

cmdbtockfO] = 

7 (Board 0) or cmdblockfO] = 107 (Board 1) 


crndblockfl j * 

Xcvr specifier 0 = NT Xcvr 

1 « LT Xcvr 


resblockfO] 

=« See Error Codes 


resblockfl-4] 

a 32-bit FEBE count, MSBs followed by LSBs. 


resbiock[5-8] 

a 32-bit NEBE count MSBs followed by LSBs. 


resblock[9-1 2] 

= 32-bit NoSyn count. MSBs followed by LSBs. 


resblock[13-16] 

= 32-bit NoAct count. MSBs followed by LSBs. 

Get HW 1 

Version 

cmdblockfO] = 

8 (Board 0) or cmdblockfO] = 108 (Board 1) 


resbiock[0] 

* See Error Codes 


resWockfl] =» 

NT xcvr version number. 


resblock(2] = 

LT xcvr version number. 

Get Link 

Status 

crndblock[0] = 

9 (Board 0) or cmdblockfO] a 109 (Board 1) 


resblockfO] 

a See Error Codes 


resbiockfl] = 

NT link status 

bit 0 = linkup 

bit 1 a superframe sync recognized 
bit 2 a Xcvr activation in progress 
bit 3 a error indicator 


resblock[2] = 

LT link status 

bit 0 a link up 

bit 1 a superframe sync recognized 
bit 2 a Xcvr activation in progress 
bit 3 a error indicator 

Transceiver 

Transmit 

cmdblockfO] = 

11 (Board 0) or cmdblockfO] a 111 (Board 1) 


cmdblockfl] = 

Xcvr specifier 0 a NT Xcvr 

1 a LT Xcvr 


cmdblockf2] a 

Channel specifier 

1 = EOC 

2 = M4 

3 = M5/M6 


cmdblock{3] a 

EOC address, EOC DM bit 


cmdb!ock{4] a 

EOC information 


cmdblock{5] = 

M4 information 


cmdblock{6] = 

M5/M6 information 

Transceiver I 

Receive 

cmdbiock[0] = 

12 (Board 0) or cmdblockfO] a 112 (Board 1) 


crndblockfl] = 

Xcvr specifier 0 a NT Xcvr 

1 a LT Xcvr 


resblock[0] 

a See Error Codes 


resbiockfl] = 

Message Length 0 a No data available 

1 a 6 data bytes follow 

2 a M4 

3 * M5/M6 




2B1Q U-INTERFACE C LIBRARY FUNCTIONS (continued) 


resblock[2] = EOC address, EOC DM bit 
resblock[3] » EOC information 
resblock[4] = EOC address, EOC DM bit 
resblock[3] = EOC information 
resblock[6] = M4 information 
resb!ock{7] = M5/M6 information 


EOC 

Processing cmdbiock[0] = 
cmdblockfl] = 

cmdbiock(2] = 


EOC Mode 
Control 


13 (Board 0) or cmdblock[0] = 113 (Board 1) 
Xcvr specifier 0 = NTXcvr 
1 . LT Xcvr 
Automatic processing mode 

1 = No action 

2 = Operate 2B + D Loopback 

3 = Operate B1 Loopback 

4 = Operate B2 Loopback 

5 * Send corrupted CRC 

6 = Return to Normal 


cmdblock[0] = 14 (Board 0) or cmdblock[0] = 114 (Board 1) 
cmdbiockjl] = Xcvr specifier 0 = NTXcvr 

1 > LT Xcvr 

cmdblock[2j = EOC Reception mode 

1 = No action 

2 = Handle every EOC 

3 s Handle EOC passing trinai checks 

4 * Handle EOC passing trinai checks 

with automatic EOC processing 


M4 Mode 
Control 


cmdblock[0] 

cmdblockfl] 


= 15 (Board 0) or cmdblock[0] = 115 (Board 1) 


cmdblock(2] = 


Xcvr specifier 0 

M4 Reception mode 
0 

1 = 

2 = 

3 = 

4 = 


NT Xcvr 
LT Xcvr 

No action 

Handle duai-consecutive M4 with 
verified act/dea 
Handle dual— consecutive M4 
Handle Delta M4 
Handle every M4 


M5/6 Mode 

Control cmdblock[0] 
cmdblockfl] 


= 16 (Board 0) or cmdbiock[0] = 116 (Board 1) 


cmdblock(2] = 


Xcvr specifier 0 

1 = 

M4 Reception mode 

0 as 

1 = 

3 = 

4 = 


NTXcvr 
LT Xcvr 

No action 

Handle dual-consecutive M5/6 
Handle Delta M5/6 
Handle every M5/6 


Shutdown cmdblock[0] = 30 (Board 0) or crndblockfO] = 1 30 (Board 1 ) 
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BSC C LIBRARY FUNCTIONS 






C PRIMARY RATE INTERFACE LIBRARY FUNCTIONS 


FILENAME: iibpri.a 

SetPrirnary int SetPrimary(cmdblock, resblock); 
intcmdblock [14]; 
int resblock [14]; 

The error codes for resblock[0] for ail Primary Rate Interface Library commands are: 
resblockJOj Meaning 

0 Successful 

1 Primary Rate Interface board is not installed 

2 Setup already done 

3 I nvalid channel num ber/tim e slot 

4 Selection already in use 

5 Channel already assigned 

1 0 Command not implemented 

Setup cmdblock[0] =» 1 (Board A) or cmdbiock[0] =.101 (Board B) 
cmdblock[1] mode 1 Monitor 
2 Simulate 

cmdblock[2] framing 1 04 

2 ESF 

3 SL96 

4 CEPT 

cmdblock[3] idle data 8 bit value 

cmdbiock[4] idle signal 2 or 4 bit value 

*cmdblock{5] DSOx receive Channel/time slot 

*cmdblock[6] Codec receive Channel/timeslot 

*cmdblock[7] DSOy receiver/transmitter Channel/timeslot 

*cmdbiock[8] Codec transmitter Channel/time slot (Ignored in Monitor mode) 

*cmdbiock(9j Milliwatt transmitter Channei/time slot (ignored in Monitor mode) 

*cmdbiock[10] Status line 1 one byte (See Setup byte interpretation on next page.) 

cmdblock(11] Statusline2 onebyte(SeeSetupbyteinterpretationonnextpage.) 

* Available for line 1 only. 

Resynchronize cmdbiockfO] » 2 (Board A) or cmdblock[0] * 1 02 (Board B) 

Argument None 

Reset cmdbiock(0] =• 3 (Board A) or cmdbiock[0] =» 1 03 (Board B) 

Argument None 

Channel cmdblockfO] = 4 (Board A) or cmdblock[0] » 1 04 (Board B) 

Functions cmdblockfl] mode 0 If request conflicts with current setup, retain current setup. 

1 if request conflicts with current setup, override current 
setup. 

cmdblock[2] selection 1 DSOx receive 

2 Codec receive 

3 DSOy transmit 

4 DSOy receive 

5 Codec transmit 

6 Milliwatt transmit 

7 Reset transm it channel 

8 Reset receive channel 

9 Idle data 

10 Idle signal 

cmdblock[3] channel (if cmdbiock[2]- 1—8) 

1 - 24 D4/E5F Sine 1 
1 - 31 CERT line 1 

cmdblock{3] idle bits (if cmdblcck[2)^9 -10) 

8, 4, 2, bits 
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Reserved cmdblockfO] « 5 (Board A) or cmdblockfO] - 1 05 (Board B) 

Reserved for future use. 


Get Status cmdblockfO] * 6 (Board A) or cmdblock(0] = 106 (Board B) 

Argument None 

Returns the current configuration in the Setup command configuration format. 

Change Status cmdblockfO] = 7 (Board A) or cmdblockfO] = 107 (Board B) 
cmdblockfl] line 1 or 2 

cmdblock{2] status 8 bits, interpreted as follows: 

7 6 5 4 3 2 1 0 
Bit XXXXXXXX 


Zero suppression 
0=Off 
1=On 

Reserved 

Signaling 
0»Off 
1 -On 

Data rate (ANSI only) 
0=64k 
1=56k 

Milliwatt tone (CEPT only) 
0=820 
1=1020 

DS0 Bit Inversion 
0=Qft 
1=On 

CRC Enable (CEPT only) 
0=CRC Enable off 
1 =CRC Enable on 

Line 

O-Off 

1=On 



Enable Trace cmdblockfO] = 9 (Board A only) 

cmdbiockfl ]8 trace bits, interpreted as follows: 


7 6 5 4 3 2 1 0 

XXXXXXXX 



Trace I/O to the Hardware 
0=Qff 
1»On 

Trace Command Block 
0=Off 
1=On 

Trace Result Block 
0=Off 
1=On 

Trace Configuration 
0=Off 
1 —On 

Reserved 


Pri_version Returns the current verion of the PRI li- 
brary. 

char *Pri_version(); 





ASYNC LIBRARY QUICK REFERENCE 


ASYNC LIBRARY FILENAME: libasc.a 


1NITP1 Initializes PI and loads simulation 
software. 

int initp^ (type, encode) 
int type; Q-DCE 

1-DTE 

struct ASC_CTRL 'encode 

struct ASC_CTRL 

{ 

int bitrate; 
int parity; 
int stop; 
int data; 
int duplex; 
int block; 
int eob; 

}; 


bitrate 

1 

SO 7 

1200 


2 

75 8 

2400 


3 

110 9 

4800 


4 

150 10 

9600 


5 

300 11 

19200 


6 

600 


parity 

0 

None 



1 

Odd 



2 

Even 


stop 

0 

1 Stop bit 



1 

1 .5 Stop bits 



2 

2 Stop bits 


data 

5 

5 Data bits 



6 

6 Data bits 



7 

7 Data bits 



3 

8 Data bits 


duplex 

0 

Full duplex 



1 

Half duplex 


block 

0 

Block mode 



1 

Character mode 


eob (End of block character): O-QxFF 

Returns: 

Q«Successful 
-1 -Invalid parameter(s) 

-2-PI program not loaded 
-3- Port is busy 


RECEIVE Receives a block or character from PI 
and places it at address pointed to by 
frame. 

char receive (frame) 
char 'frame; 

Returns: 

0-Good BCC or no frame waiting 
1 —Bad BCC 

2- initpl not performed 

3- Overflow 

T8REAK Transmits a break sequence, 
int tbreak() 

TRANSMIT Transmits number of bytes in length, 

starting at address pointed to by 'frame, 

with the control characters and BCC as 

specified by mode. 

int transmit! frame, length) 

char 'frame; 

int length; 

Returns: 

0- Successful 

1- PI busy 

2- initpl not performed 

3- Parameter error 

4- Burfer overflow 

TREADY Returns status of PI transmitter, 
int treadyQ 
Returns: 

0- Transmitter ready 

1 - Transmitter not ready 

2- initpl not performed 

3- Overflow 






FILENAME: libanal.a 


init_anal This function initializes the hardware and loads the analysis software, 
int init_anai(port, protocol, par) 
int port, protocol; 
union PARBLOGK *par; 

Port 0 Port A 

1 Port B 

2 Port A and B 

Protocol 1 BOP 

2 ISDN 

7 Async 

8 BSC 

Par: 

union PARBLOCK { /* BOP parameter block 7 

struct { 

unsigned short nrz; 

Jpbop; 

struct { r Bisync parameter block 7 

unsigned short table; 
unsigned short bsc; 
charsyncl ; 
charsync2; 
unsigned short parity; 

Jpbisync; 

struct { /’ Async parameter block 7 

unsigned short baud; 
unsigned short parity; 
unsigned short databit; 

Jpasync; 

}; 

BOP and 

ISDN If Protocol - 1 (BOP) or 2 (ISDN), the following parameter must be initialized: 
par— >pbop. encode 0 NRZ 

I NRZ! 

ASYNC if Protocol » 7 (Async), the following three parameters must be initialized: 
par->pasync.baud2 75 baud rate 
3 110 

5 300 

6 600 

7 1200 

8 2400 

9 4800 

10 9600 

II 19200 

par->pasync.parity 0 None 

1 Odd 

2 Even 

par->pasync.databit 5 5 data bit 

6 6 data bits 

7 7 data bits 

8 8 data bits 






C ANALYSIS LIBRARY FUNCTIONS -CONTINUED 


BSC If Protocol's (BSC), the following parameters must be initialized: 

par->pbsync.table 0 ASCII 

1 EBCDIC 

par->pbsync.bcc 0 CRC16 

1 LRC 

2 ccrrr 

par->pbsync.synct Range: O-Oxff 

par->pbsync.sync2 Range: O-Oxff 

AND it par->pbsync.table is initialized to ASCII the following parameter 
must also be initialized: 
par->pbsync.parity 0 None 

t Odd 

2 Even 


Returns 0 

Successful 

-1 

Parameter error 

-2 

Dual ports not available 

-3 

Cannot toad analysis files. 

—4 

Simulation is running 

-5 

Port is busy 


getevent This function gets an event from the line, if available. Event is a special data type definition which is 
defined in a:\include\cham.h. It is defined as follows: 
typedef struct { 

unsigned short type; /'event.type Bit-mapped information element (see figure 

beiow)’/ 

unsigned short length; /'eventJength The length of the data V 

unsigned short buflen; /"event.bufien Data buffer length*/ 

unsigned char *pdata; /*event.pdata Data buffer address that points to the frame'/ 

long seconds: /*event.secondsNumber of seconds since midnight or noon*/ 

long ms20; /’event.ms2Q Number of 20 microseconds since the second*/ 

unsigned short special; /'event. special If a baud rate event the baud rate change event 

contains the new baud rate value. If a lead 
transition event, the bits indicate the lead states. 
7 

unsigned short crc; /'eventcrc The crc of the frame*/ 

unsigned short flags; /*event.flags For BOP only, contains the number of flags*/ 

} event; 

#inc!ude <cham.h> 
int getevent(pevent) 
event *pevent; 

Returns 0 Successful 

-1 No new events 

-2 Data overwitten (buffer wrapped) 



reset_anal Resets the acquisition processor, 

int reset_anal() 
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MULTI-LINK LAPD LIBRARY QUICK REFERENCE 


MULTI-LINK LAPD LIBRARY Filename: libmland.a 


find Jink Returns the number of the lowest link 

matching the SAPl/TEI/TGE value 
specified. 

int find llnk(sapi,tei,tgi) 
int sapi, tei, tgi; 

Returns: 

0-63 Matching link number 
-1 No match found 

getjreelink Gets the number of first disabled link, 
int getjreelink() 

Returns: 

0-63 Disabled link number 
-1 No tee links 

-2 initpl not performed 

getjwaiting Gets the number of Wrames waiting 
to be transmitted on the link, 
int getjwaiting (Inkn) 
char Inkn; 0-63 
Returns: 0-7 No. of Wrames 

get Jink Gets the number of the link currently 

under user control, 
int getjink() 

Returns: 

0-63 Current link no. 

-1 initpl not performed 

get Inksapi Gets the SAP! value for linkn. 
int get Inksapi (Inkn) 
char Inkn; 0-63 
Returns: 

0-63 SAPI value 

> 63 Disabling SAPI value 

getjnktei Gets the TEI value for link Inkn. 
int get inktei (Inkn) 
char Inkn; 0-63 
Returns: 

0-127 TEI value 

> 127 DisabiingTEI value 

getjnktgi Gets the TGI value for link inkn. 
int getjnktgi (Inkn) 
char Inkn; 0-63 
Returns: 

0-14 TGI value 
15-255 Disabling TGI value 

get_meswaiting Gets no. of messages waiting 
to be received from the FEP. 
int getjneswaiting () 

Returns; 0 — 32 No. of msgs. 

get_rlink Gets the number of the link which 

sent the last received message, 
int get jlink() 

Returns: 

0-63 Current link no. 

-1 No messages rec’d 

-2 initpl not performed 



get_rntei 

Dummy function to maintain 
compatibility with single link 
LAPD programs that are being 
upgraded to MuitMJnk LAPD. 
int getjntei (val) 
int val; 

get_rsapi 

Dummy function to maintain 
compatibility with the existing 
single link LAPD programs that 
are being upgraded to Multi-Link 
LAPD. 

int getjsapi (vai) 
int val; 

get_rxstat 

Gets the low order byte of the 
frame status byte frstat for the 
last received message, 
char get_rxstat() 

Returns: 

0~0xC3 frstat value 

OxFF No messages reed 

OxFE initpl not performed 

get_sapi 

Gets the SAPI value of the link 
currently under user control, 
int get_sapi() 

Returns: 0 - 255 SAPI value 

get_sconfig 

Returns a copy of the current 
control configuration byte, 
int get_sconfig () 

get_sim 

Returns a copy of of the network/ 
subscriber selection, 
int getjsim () 

Returns: 0 Network 

1 Subscriber 

getjei 

Gets the TEi of the link currently 
under user control, 
int getjeif) 

Returns: 0 - 255 TEI value 

getjgi 

Gets the TGI of the link currently 
under user control, 
int get jgi() 

Returns: 0-14 TGI value 

15-255 Disabling TGI value 

get_window 

Gets the number of outstanding 
Wrames on link number Inkn. 
int get_window (Inkn) 
dial Inkn; 0-63 

pboneRe turns: 0-7 No. of I-frames 
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MULTI-LINK LAPD LIBRARY (continued) 


initpl initpl loads the Front End Process (FEP) 
code for the selected library and starts 
simulation. This is the same as the 
start_sim function, but is included for 
downward compatibility with the single 
link LAPD library. 

int initpl (interface, sta, encode, bitrt) 
int interface, sta, encode; 
long bitrt; 

interface 0 V-type interface (DCE) 

1 V-type interface (DTE) 

2 ISDN interface 

sta 0 Network 

1 Subscriber 

encode 0 NRZ 

1 NRZ! 
bitrt 50-64000 

link_stat Gets tie current state of link n. 
int Iink_stai(n) 
char n; 0-63 

Returns: 0-9 Current state 

0 Link Disconnected 

1 Link Connection Requested 

2 Frame Rejected 

3 Disconnect Requested 

4 Information Transfer 

5 Local Station Busy 

6 Remote Station Busy 

7 Local & Remote Station Busy 

8 Remote Stn not Responding 

9 Link Disabled 

receive Receives a message from the FEP 
int receive(dest_addr) 
char *dest_addr; 

S_n200 Sets maximum number of retries (N2Q0). 
int s_n200 (val) 
int val; 1 - 255 
Returns: 0 Successful 

S_n201 Sets maximum length of an Wrame 
(N201 ). 

int s_n20l (val) 
int val; 1-512 
Returns: 0 Successful 

s_t2Q0 Sets the time allowed for the remote 

station to respond (T20Q). Setting this 
value to 0 disables the T200 timer, 
int sJ2Q0 (val) 
int val; 0-255 
Returns: 0 Successful 

SJ203 Sets the maximum time between frames 
(T203). Setting this value to 0 disables the 
T2Q3 timer, 
int SJ2G3 (val) 
int val; 0 - 255 
Returns: 0 Successful 


set Jink Puts link n under user control. Only one link 
at a time can be under user control, 
int set Jink(n) 
char n; 0-63 

Returns: 0 Successful 

-1 Parameter error 
-2 initpl not performed 
-3 Timeout 

set_net Sets simulation side to network, 
int set_.net ( ) 

set_rntei This is a dummy function to maintain com- 
patibility with existing LAPD link programs 
that are being upgraded to Multi-Link 
LAPD. 

int set_rntei (val, tei) 
int val, tei; 

set_rsapi This is a dummy function to maintain com- 
patibility with existing LAPD programs that 
are being upgraded to Multi-Link LAPD. 
int set_rsapi (val, sapi) 
int val, sapi; 

This function always returns zero. 

set_sapi Sets the SAPI value for the link under user 
control. 

int set_sapi(v) 
char v; 

Accepted range of vis 0-255. A 
value over 63 will 
disable the selected link. 

Returns: 0 Successful 

-1 Parameter out of range 
-2 initpl not performed 
-3 Timeout 

set_sco nf i g Sets the val ue of the control config- 
uration byte 
int set_sconfig (byte) 
irrt byte; 

Returns: 0 Successful 

set_sub Set the simulation side to Subscriber, 
int set_sub ( ) 

setjei Sets the TEI value for the link under user 
control, 
int setjei(v) 
char v; 0 to 255 

> 127 diabies link 
Returns: 0 Successful 

-1 Parameter error 
-2 initpl not performed 
-3 Timeout 
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MULTI-LINK LAPD LIBRARY QUICK REFERENCE (continued) 


setjgi Sets the TGI value for the link under 
user control, 
int set_tgi(v) 

char v; 0 to 14 TGI value 

15-255 Diables use of TGI 
Returns: 0 Successful 

-1 Parameter error 

-2 initpl not performed 
-3 Timeout 

set_window Sets the maximum number of 
outstanding frames on each link, 
int sei_window (val) 
intvai; 1-7 

Returns: 0 Successful 

setflg Selects an interframe fill pattern, 
int setflg (flag) 
int flag; 0 0x7E fill 

1 OxFF fill 

Returns: 0 Successful 


slot Disconnects the link, 

int siof () 

Returns: 0 Successful 

slon Attempts to establish a link, 

int slon () 

Returns: 0 Successful 

srch Jnk Returns the number of lowest link 
matching the specified SAPI/TEI. 
int srch Jnk(sapi.tei) 

Returns: 0-63 No. of lowest link 

-1 No match found 

start_sim start_sim loads the Front End 

Process (FEP) code for the selected 
library and starts simulation. 

(identical to initpl function.) 

int start_sim (interface, sta, encode, bitrt) 

int interface, sta, encode; 

long bitrt; 

interface 0 V-type interface (DCE) 

1 V-type interface (DTE) 

2 ISDN interface 

sta 0 NETWORK 

1 SUBSCRIBER 

encode 0 NRZ 

1 NRZ! 

bitrt 50 - 64000 

status Gets the current state of link under 
user control, 
int status( ) 

Returns: 0-9 Current state (see 

fink_state table on pre- 
vious page) 


trans Transmits a frame. 

int trans (frame, address, ien) 
int frame, Ien; 
char ’address; 

frame selects type of frame to transmit: 
0x80 Mrame Sequenced l-frame 
0x81 U! Unnumbered Mrame (NSi) 
0x82 XIDC XID command frame 
0x83 XIDR XID response frame 
address is a pointer to the first byte of the 
message. Ien is the length of the message 
to be transmitted. 

Returns: 0 Successful 

int transmit (xloc, xlen) 
char *xioc; 

int xlen; 

xloc is a pointer to the first byte of the mes- 
sage. xien is the length of the message to 
be transmitted. 

Returns: 0 Successful 

trui Transmit a message in an unnumbered I- 
frame (Ul frame), 
int trui (xloc, xlen) 
char 'xloc; 
int xlen; 

xloc is a pointer to the first byte of the mes- 
sage. xlen is the length of the message to 
be transmitted. 

Returns: 0 Successful 

trxcnl Transmits an XID command frame with no 
data field, 
int trxcni ( ) 

Returns: 0 Successful 

trxidc Transmits a message in an XID command 
frame. 

int trxidc (xioc, xlen) 
char 'xloc; 
int xlen; 

xloc is a pointer to the first byte of the mes- 
sage. xlen is the length of the message to 
be transmitted. 

trxidr Transmit a message in an XID response 
frame. 

int trxidr (xloc, xien) 
char ‘xloc; 

xloc is a pointer to the first byte of the mes- 
sage. xlen is the length of the message to 
be transmitted. 

Returns: 0 Successful 

trxrni Transmits an XID response frame with no 
data field, 
int trxrni ( ) 

Returns: 0 Successful 






GET_FREEUNK() Gets the number of first disabled Sink 
int get_freelink() 

Returns: 

0-63 Disabled link number 

-1 No free links 

-2 initpl not performed 

GET_FWAITING Gets the number of (-frames wait- 
ing to be transmitted on link, 
int get_fwaiting (Inkn) 
char Inkn; 0-63 

Returns: 0-7 No. of 1-frames 
GET_LINK() Gets tie number of the link cur- 
rently under user control, 
int getjink( ) 

Returns: 

0-63 Current link number 

GETJJLIQ Gets the LLI of the link currently 
under user control, 
int getjli() 

Returns: 

0-63 Current link number 


GET_LNKLLJ Gets the LLI value for link Inkn. 
int get Jnkiii (Inkn) 
char Inkn; 0-63 
Returns 

0-Gxlfff LLI value 
>0x1 fff Link inkn is disabled 
GET_MESWAfTING Gets no. of messages wait- 
ing to be received from the 
PEP. 

int getjneswaiting ( ) 

Returns: 

0-32 No. of messages 

GET_RL!NK() Gets the number of the link which 

sent the last received message, 
int get_riink( ) 

Returns: 0-63 Current link 
-1 No messages reed 

-2 initpl not performed 

G£T_RXSTAT() Gets the low order byte of the 
frame status byte frstat for the 
last received message, 
int get_rxstat() 

Returns: 

0-0xC3 frstat value 

OxFF No messages reed 

OxFE initpl not performed 

GET_SCONFIG ( )Retums a copy of the current con- 
trol configuration byte, 
int get_sconfig ( ) 
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GET_WINDOW Gets the number of outstanding I— 
frames on link number Inkn. 
int get_window (Inkn) 
char Inkn; 0-63 
Returns: 0-7 No. of Wrames 

INITP1 Starts the simulator (same as start_sim). 

int initpl (interface, sta, encode, bitrt) 
int interface, sta, encode; 
long bitrt; 

interface 0 V-type interface (DCE) 

1 V-type interface (DTE) 

2 ISDN interface 
Sta 0 NETWORK 

1 SUBSCRIBER 
encode 0 NRZ 
1 NRZi 

bitrt 50 - 64000 

L1NK_STAT Gets the current state of link n. 
int iink_stat(n) 
charn; 0-63 

Returns: 0-9 Current state 

0 Link Disconnected 

1 Link Connection Requested 

2 Frame Rejected 

3 Disconnect Requested 

4 information Transfer 

5 Local Station Busy 

6 Remote Station Busy 

7 Local & Remote Station Busy 

8 Remote Stn not Responding 

9 Link Disabled 

RECEIVE Receives a message from the FEP 
int receive(dest_addr) 
char *dest_addr; 

S_N2Q0 Sets the maximum number of retries 
(N20C). 

int s_n200 (vai) 

int vai; 1 - 255 

Returns: 0 Successful 

S_N2Q1 Sets the maximum length for an (-frame 
(N201 ). 

ints_n201 (vai) 

int vai; 1-512 

Returns: 0 Successful 

S_T200 Sets the time allowed for the remote 
station to respond (T200). Setting this 
value to 0 disables the T200 timer, 
int s_t200 (vai) 
int vai; 0 - 255 
Returns: 0 Successful 
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S_T203 Sets the maximum time between 
frames (T203). Setting this vaiue to 0 
disables the T203 timer, 
int s_t203 (vai) 
intvai; 0-255 
Returns: 0 Successful 

SET_SCONF!G Sets the value of the control 
configuration byte 
int set_sconfig (byte) 
int byte; 

Returns: 0 Successful 

SETJJNK Puts link n under user control, 

int setjink(n) 
char n; 0-63 

Returns: 

0 Successful 

-1 Parameter out of range 

-2 initpl not performed 

—3 Timeout 

SETJ.LI Sets the LLI value for the link under 
user control. A value over Ox 1 FFF dis- 
ables the link, 
int setjii(val) 

int val: 0x00 - OxFFFF hex 

Returns: 

0 Successful 

-I Parameter out of range 

-2 initpl not performed 

-3 Timeout 

SET_WINDOW Sets the maximum number of 
outstanding frames on each link, 
int set_window (val) 
int vai; 1 - 7 

Returns: 0 Successful 

SETFLG Selects an interframe fill pattern, 
int setfig (flag) 
int flag; 0 0x7E fill 

1 OxFF fiii 

Returns: 0 Successful 

SLOP ( ) Sends a DISC and waits for a UA. 
int slof { ) 

Returns: 0 Successful 

SLON ( ) Sends a SABME and waits for a UA. 
int slon ( ) 

Returns: 0 Successful 

SRCH_LNK Returns the number of lowest 
link matching the specified SAPI/TEI. 
Int srchjnk(sapi,iei) 

Returns: 0-63 Link no. 

-1 No match 

STATUS( )Gets the current state of current link, 
int status() 

Returns: 0-9 


START_SIM Starts the simulator (same as initpl ). 
n=start_sim (interface, sta, 
encode, bitrt) 
int n, interface, sta, encode; 
long bitrt; 

interface 0 V-type (DCE) 

1 V-type (DTE) , 

2 ISDN interface 

sta 0 NETWORK 

1 SUBSCRIBER 

encode 0 NRZ 

1 NRZI 

bitrt 50 - 64000 

TRANS Transmite a frame. 

int trans (frame, address, Jen) 
frame selects type of frame to transmit: 
0x80 l-frame Sequenced (-frame 

0x81 Ut Unnumbered l-frame 

(NSI) 

0x82 X1DC XID command frame 

0x83 XIDR XID response frame 

address is a pointer to the first byte of 
the message, len is the length of the 
message. 

Returns: 0 Successful 

TRANSMIT Transmits a message in a se- 
quenced (numbered) l-frame. 
int transmit (xioc, xlen) 
char ’xioc; 
int xlen; 

TRANS_R£SP Transmits a message in a 
sequenced (-frame response, 
int trans_resp (xioc, xlen) 
char 'xioc, 
int xlen; 

TRUI Transmit a message in an unnumbered 
l-frame (U! frame), 
int trui (xioc, xlen) 
char *xloc; 
int xlen; 

TRXCNI Transmits an XID command frame with 
no data field, 
int trxcni ( ) 

TRX1DC Transmits a message in an XID 
command frame, 
int trxidc (xioc, xlen) 
char 'xioc; 
int xlen; 

TRXIDR Transmit a message in an XID 
response frame, 
int trxidr (xioc, xien) 
char *xloc; 

TRXRNl Transmits an XID response frame with 
no data field, 
int trxrni () 
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libmhdlc.a 

flush Clears the receive buffer of the current- 

ly selected port, 
flush () 

Returns: None 

flush all Clears the reception buffer of both 
ports. 
flush_all() 

Returns: None 

init_a Initializes Port A. 

int init_a {interface, sta, encode, 
bitrt) 

int interface, sta, encode: 

long bitrt; 

interface 0 DCE 

1 DTE 

2 ISDN 

sta 0 Network 

1 Subscriber 
encode 0 NRZ 
1 NRZ! 

bitrt 50 to 64000 bps 

Returns: 0 Successful 

-1 Parameter error 

init Jj Initializes Port B. 

int init_b (interface, sta, encode, 
bitrt) 

int interface, sta, encode; 

long bitrt; 

interface 0 DCE 

1 DTE 

2 ISDN 

sta 0 Network 

1 Subscriber 
encode 0 NRZ 
1 NRZ! 

bitrt 50 to 64000 bps 
Returns: 0 Successful 

-1 Parameter error 

initpl Initializes Ports A and B. 

int initpl (interface, sta, encode, 
bitrt) 

int interface, sta, encode; 

long bitrt; 

interface 0 DCE 

1 DTE 

2 ISDN 

sta 0 Network 

1 Subscriber 
encode 0 NRZ 
1 NRZ! 

bitrt 50 to 64000 bps 
Returns: 0 Successful 

-1 Parameter error 


mlh_f lush Clears the receive buffer of the speci- 
fied port, 
mlhjlush (port) 
int port; 

port 0 Port A 

1 Port B 

mlh_receive Causes the Chameleon to 
check for a received packet, 
int mlh_receive (loc) 
char *ioc; 

loc Pointer to the receive 

buffer. 

It sets the global variable rec _port, 
as follows: 

0 No packet was received 

1 Packet received from Port A 

2 Packet received from Port B 

Returns: 

0 No packet in buffer 

2 FEP not initialized 
1 28 Packet received 

mlh_sei_nl Sets the N 1 value forthe speci- 

fied port. 

int mlh_set_.nl (port,val) 

int portval; 

port 0 Port A 

1 Port B 

vat N1 value (1 to 512) 

Returns: 0 Successful 

-1 Parameter error 

mih_set_n2 Sets the N2value forthe speci- 

fied port 

int mlh_set_n2 (port,val) 
int portval; 
port 0 Port A 

1 PortB 

val N2 value (1 to 512) 

Returns: 0 Successful 

-1 Parameter error 

mlh_set_net Sets the specified port to act as 

a network. 

int mih_set_nef (port) 
int port, val; 
port 0 Port A 

1 Port B 

Returns: 0 Successful 

mlh_set_tl Sets the value of the T 1 timer 

for the specified port 
Int mlh_set_tl (port, val) 
int port, val; 
port 0 Port A 

1 PortB 

val T1 value (1 to 255) 

Returns: 0 Successful 

-1 Parameter error 
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set_ratio Selects a distribution pattern for trans- 
mitting packets using mlh_trans(). It 
specifies the percentage of packets to 
be transmitted over Port A. 
int set_ratio (pct_a) 
int pctja; 

pct_a The percentage of pack- 

ets to be transmitted over 
Port A. Valid values are 0 
to 100 in increments of 
10, and -1. For example: 

-1 All packets are trans- 

mitted over both Ports A 
and B. 

0 0% of the packets are 

transmitted over Port A. 

1 0 1 0% of the packets are 

transmitted over Port A. 
Returns: 0 Successful 

-1 Parameter error 

set_sub Configures both ports to act as sub- 
scribers, 
int set_sub () 

Returns: 0 Successful 

set_t1 Sets the T1 timer to an identical value 
for both ports, 
int set_tl (val) 
int val; 

val T1 value (1 to 255) 

Returns: 0 Successful 

-1 Parameter error 

set_t2 Sets the T2 timer to an identical value 
for both ports, 
int set_t2 (val) 
int val; 

val T2 value (1 to 255) 

Returns: 0 Successful 

-1 Parameter error 


set_window Sets the window size to an 
identical value for both ports, 
int set_window (val) 
int val; 

val Window size (1 to 7) 
Returns: 0 Successful 

-1 Parameter error 

slot Disconnects the link on both ports . 
int slof () 

sion Attempts to establish a link on both 
ports by sending a SABM. 
int slon () 

status Returns the link status of the currently 
selected port, 
int status () 


Returns: 

0 

Disconnected 


1 

Link conn. re- 

quested 

2 

Frame reject 

state 

3 

Link disconn. req. 


4 

Information xfer 

state 

5 

Local station busy 


6 

Remote station 

busy 

7 

Local & remote 


stations busy 

transmit Transmits a packet over Tie specified 
port. 

int transmit (port, xloc, xlen) 
char port.’xioc; 
int xlen; 

port 0 Port A 

1 Port B 

xloc Pointer to the packet 

xlen Length of the packet 

Returns: 0 Successful 
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Application Programmer’s interface C LIBRARY: 
lifaui.a 

The Application Programmer’s interface C Library 
provides function which enable you to develop 
applications with pull-down menu interfaces. The 
library contains the functions and commands described 
below. For descriptions of the data structures used by 
the functions, refer to tie Application Programmer’s 
interface manual. 

addNewLine inserts one line at a time to a list 

selector. 

addNewLine (s, str) 

SCRAREA *s; 

byte *str, 

’s Pointer to scrolling area of a BOX- 
REQ. 

*str Pointer to the string to be in- 
serted. 

Returns: None 

box_input BOXJNPUT creates a list box of selections 
atom-time.. See box_req for more informa- 
tion. ~ 

box_req The structure type BOXREQ is used to de- 
fine the box. 

cSToggie Marks a specified position within a box or list 
selector with a character. 
cSToggie (s, n, mode, ch, chi) 
SCRAREA *s; 

int n, mode; 

char ch, chi; 

s A pointer to the scroll- 

ing area within a BOXREQ 
n Position within the box 

mode 0 Toggle 

1 Set 

ch First marker character 

chi Second marker char- 

acter 

Returns: 0 Set to first marker, ch. 

1 Set to second marker, 
chi 

dsp _req Displays text within a window. The structure 
type DSPREQ is used to specify the infor- 
mation to be displayed. 

erase_fie(d Request to erase a specific field from a win- 
dow. This will erase both the description 
and the associated value. 

eraseb _reqThis requestthat an entire list box be erased 
from the screen. The structure required for 
this request is of the type ERASER EQ. 

erasew_req This requests that a window be 

erased from the screen. The structure re- 
quired for this request is of the type ERAS- 
ERQ. 

eraseEOS This function erases the screen from line 3 
downward. It is useful in conjunction with 
pull down menu logic. 
eraseEOS( ) 

Returns: None 


fiilBoxArea This function initializes tie scroll- 

ing linked list located within the structure 
BOXREQ. This must be done once, typical- 
ly in tie beginning of the program, before a 
box or list selector can be accessed through 
a call to userinterface(). 
fiilBoxArea (req, striist) 

BOXREQ *req; 

byte ‘striistQ; 

req A pointer to BOXREQ 

striist Address of the array 

containing the strings to be entered in 

the list box 

Returns: None 

getBoxArea This function allocates space to 

the scrolling area of a list selector. The 
linked list is also initialized. If the area 
needs to be re-initialized at any point this 
function can be called again. 

getBoxArea (breq) 

BOXREQ *breq; 

Returns: None 

getFileChoice This function displays a list of files. 

The function reads. the directory specified 
by the path for each occurence of a file with 
the specified extension. For each occur- 
ence, the filename is loaded into the list se- 
lector. 

getFileChoice (boxName, fPath, 
ext, bTitle, errMsg, insFlag, inserts, 
fnum, conf) 

BOXREQ 'boxName; 

byte 'fPath; 

byte *ext; 

byte *bTitie; 

byte 'errMsg; 

int insFlag 

byte " inserts; 

int fnum; 

BOXCONF 'conf; 

“boxName A pointer to BOXREQ 
'fpath Directory path 

'ext Rie extension 

“bTitie Title string to be displayed 

'errMsg Error string that will be dis- 
played at if no files exist 
insFlag When set to TRUE, this in- 

serts the number of lines specified in fnum 
into the list box. Otherwise, set to FALSE, 
"■inserts A pointer to an array of 
strings to be inserted when insF?ag=TRUE. 
Otherwise set to NIL 

fnum When insFlag is set to true, 

this is the number of lines to be inserted. 
*conf A pointer to the BOXCONF 

structure. 

Returns: The BOXCONF structure 

contains exit information. 






APPLICATION PROGRAMMER’S INTERFACE C LIBRARY 


initUI This function initializes the user inter- 
face. initUI() must be called before any 
other cal! is made to the interface. 
initUI {dsp, box, req, nw, nb) 
DISPLAY ‘dsp; 

BOX ‘box; 

WINDOWREQ *req; 


int 

nw; 

nb; 

int 

*dsp 

A pointer to the window ad- 
ministration area 

‘box 

A pointer to the list box ad- 
ministration area 

‘req 

window initiation of ER- 
RORJV1NDOW 
(This is required) 

nw 

NUM OF WINDOWS 

nb 

NUM_OF_BOXES 

Returns: 

None. 


input_req This command displays a sequence of 
fields to be edited. The following keys 
can be used during runtime operation 
to modify the field values. 

CTRL-N Go to the next field 

CTRL-P Go to the previous field 

CTRL-1 Insert mode (De- 

fault=overwrite) 

CTRL-0 Delete to end of line 
CTRL-A Go to the beginning of 

the line 

CTRL-E Go to the end of the line 
RETURN Go to the next field 
Space Bar Toggle between preset 
values 

There are three types of structures 
required to initiate an INPUT_REQ. 
The INPREQ structure defines the lo- 
cation and color of parameters dis- 
played, the prompt text and other 
messages. 

The INPUT_FIELD_TYPE structure 
defines a field on the screen. To de- 
fine a sequence of fields, an array of 
these structures is declared. The last 
entry of this array is defined as {0, 0, 
0, 0 ,0 , ...} or zero for all values. 

The FKEY_FIELD_TYPE structure 
defines the preset acceptable values 
for a field. 


rel_req This request is used to de-alfocate the 
memory set aside for a window and re- 
leases the associated window number. 
This should be done when a window 
will not be used again. 

unMark This function removes all marks used 
to identify selections within a list box. 
unMark (s) 

- SCRAREA ‘s; 

*s A scroll area within the box 

to be cleared 
Returns: None 

userlnterface This function gives the user ac- 

cess to the user interface. Each library 
request or command is initiated 

through a call to this function, 
userlnterface (req, conf, dsp, box) 
byte *req; 

byte ‘conf; 

DISPLAY *dsp; 

BOX ‘box: 

req A pointer to the structure 

containing the request 

type or event 

box A pointer to the list box ad- 

ministration area 

The output is put in a structure of the 
type CONFIRM, where applicable. 

window_req The command WIN- 

DOW_REQ can be used to initialize a 
window which will display information 
or it can display a frame around an input 
request. 

The parameters for the WIN- 
DOW_REQ are incorporated into four 
structures: 

WINDOWREQ 

FIELD 

FIELD JDEF 

FIELD SEQ 
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TASK COMMUNICATION C LIBRARY 



MB_MESS structure: 
typedef struct { int port ; 


ten 

pdata 


int type ; 
int info ; 
int ten ; 
char *pdata ; 

MBJWESS ; 

Origin or the destination of a message: 
PORT_A or PORT_B 
Type of message sent or received: 
CT_ERR error message 

CT_DATA data message 

CTJEXIT exit message 

CT_CMD command message 

CT_FLUSH flush the reception buffer 
User defined field when type= CT_ERR 
or type * CT_CMD 
Length of data if type=CM_DATA 
Pointer to the data received or sent. 


The library provides the following functions: 

com chkmb Checks for received messages. 
#include “com.h” 
int com_chkmb(pmess) 

MB_MESS *pmess ; 
pmess pointer to a MB_MESS struc- 
ture describing the received 
message. 

Within this structure, these items are 
required for all received messages: 

port For control tasks, indicates the 
port from which the message 
originated as: PORT A or 
PGRT_B 

type Type of message received: 

CT_ERR 

OCTjCMD 

0CT_DATA 

CT_FLUSH 

ct_exit 

info User defined information if type 
=CT ERR or type = 

CT_CMD 

len Length of the data if type = 
CT_DATA. 

pdata Pointer to the data received if 
type = CT_DATA. 

Returns: 0 Message received 

-1 No message received 


com„crct!mb Called by the control task to create 
the communication channels for the con- 
trol task. 

#include “com.h"’ 

int com_crctlmb(np) 
int np; 

np Number of channels to 

the control task (1 or 2) 

Returns: 0 Successful 

-1 Insufficient sys. resources 

com_crpmb Called by the protocol tasks to create 
the communication channels for the pro- 
tocol tasks. 

^include “com.h” 

int com_crpmb{port,np) 

int port; 
int np ; 

port Port where protocol task is 
going to run: PORT_A or 
PORT_B 

np Number of channels to the 
control task (1 or 2) 

Returns: 0 Successful 
-1 insufficient sys. resources 

com_dlctlmb Closes communication channels. It 
must be called by the control task prior to 
terminating. 

#inciude “com.h” 

void com_dlctimb() 
Returns: None 

com_error Reports an error to the control task 
and is called by a protocol task. 

#inciude “com.h” 

void com_error(port, status) 

int port ; 
int status ; 

port Port where protocol task will 
run: PORT_A or PORT_B 
status User field that can be 
used to tell more about the er- 
ror to the control task. 

Returns: None 

com_exit Sends an EXIT message to a proto- 
col task. It is called by the control task. 
#indude “com.h” 

void com_exit(port,rid) 

int port; 
long lid ; 

port Port where protocol task to kill 
is running: PORT_A or 
. PORT_8 

lid Loader ID returned by the 
function com_startl 
Returns: None 
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TASK COMMUNICATION C LIBRARY (continued) 







V.24 INTERFACE 


The electrical characteristics of V.24 series plugs on the Chameleon conform to the CCITT V.28 
Recommendation. 


The V.24 series plugs have the following electrical specifications: 


Line Receiver: 

• 

Impedance: 

6<Z<8{Kohms) 

• 

Max. Input Voltage 

± 25 V 

• 

Decision Threshold 

± 3 V 

Line Transmitter: 

• 

Impedance: 

< 100 ohms 

• 

Output Voltage: 

± 12V 


The connectors of the V.24 series are 25 pin socket connectors of the standard ISO DB 25. 
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V.24 PIN ASSIGNMENTS 


DB25 

Pin 

No. 


CCJTT 

Circuit 

No. 


ElA Ground incoming Out- 
going 













































































































DB25 

C 

Pin 

C 

No. 



Ground To DCE From Processed by 

DCE Chameleon 



RS232 NAME 


Frame Ground 


Transmitted Data 


Received Data 


Request to Send 


Clear to Send 


Data set Ready 


Signal Ground 


Data Carrier Detect 


+ dc Test Voltage 


- dc Test Voltage 


Unassigned 


2nd Data Carrier Detect 


2nd Clear to Send 


2nd Transmitted Data 


Transmitted Clock 


2nd Received Data 


Receiver Clock 


Receiver Dibit Clock 


2nd Request to Send 


Data Terminal Ready 


Signal Quality Detect 


Ring Indicator 


Data Rate Select 


Ext. Transmitter Clock 












































































































RS232 CABLE 


The DTE must be provided with an extension cable no longer than fifty feet. Longer cables are permitted only if 
the load capacitance at the interface point does not exceed 2500 picofarads. Restricting cable connections to 
fifty feet between the computer communications adaptor and the local data set and between the remote data 
set and the associated terminal guards against excessive signal distortion. 

For terminal emulation (page 10) and Kermit file transfer (page 11 ), you may have to use a special RS232 
cable, depending on the device you are connecting to the Chameleon. This cable configuration requires pin 7 
and 7 connected and pin 2 and 3 switched, as shown in the figure below. 


PIN 7 


PIN 3 


Chameleon connector. 
(Female end shown.) 


Host Connector. 
(Male end shown.) 


OOOOOO 

OOOOO 


0*0 


PIN 7 


>ooo«oo 

lOOOpO 


PIN 2 


000000*0000*0 

oooooooooooo 
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V.35 INTERFACE 


The V.35 interface module includes: 

• One male connector (reference AMP 201 357-1) 

• One female connector (reference AMP 200 838-2) 

• Standard SAE 632 mounting hardware single lead jackscrew. 

The male connector's male jackpost is near pin MM. Thefemaleconnector'sfemalejackscrewis near pin MM. 

The diameter of the pins is 0.060” for units to be used in the U.S., Japan, Australia and England. For France, 
Switzerland and Sweden, the diameter is 0.040”. 

The pins can be removed or reassigned easily using an AMP tool (reference AMP 305 1 83). 


Electrical Characteristics 


The unbalanced signals have electrical characteristics which conform to the CCITTs V.28/EIA RS232. 


Driver Output voltage: 

Output impedance: 
Output slew rate: 
Receiver Input resistance: 
Input voltage max: 
hysteresis: 


+/— 1 0 volts 
300 ohms 

30 volts/microseconds 
approximately 5 Kohms 
+/— 25 volts 
3 to 4 volts 


The balanced signals have electrical characteristics which conform to the CCITTs X.27/EIA 
RS422. 


Driver Output resistance: 
Lead to ground: 
Output current: 
Output voltage: 
Receiver Input resistance: 
Lead to ground: 
Input sensitivity: 


200 ohms differential 
175 ohms 
1 50 mA maximum 
+/- 3 volts 

200 ohms differential 
1 75 ohms 
+/- 200 mvolts 
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Pin 

No. 

CCITT 

Circuit 

No. 

Name 

m 


FG 

B 

102 

SG 

C 

: 105 

RTS 

D 

19 

CTS 

E 

107 

DSR 

F 

109 

DCD 

H 

108 

DTR 

mm 

125 

Rl 

p 

103 

TD (A) 

R 

104 

RD (A) 

S 

103 

TD (B) 

T 

104 

RD (B) 

U 

113 

SCTE (A) 

V 

115 

SCR (A) 

w 

113 

SCTE (B) 

X 

115 

SCR (B) 

mm 

114 

SCT (A) 

AA/a 

114 

SCT(B) 


From 

Type 

DCE 

DTE 

Bai 

Unbal 



RS232 Name 


Frame Ground 


Signal Ground 
Request to Send 
Clear to Send 


Data Set Ready 
Data Carrier Detect 


Data Terminal Ready 
Ring indicator 
Transmit Data 


Receive Data 


Transmit Data 


Receive Data 


Transmitter Signal Timing 
Receiver Signal Timing 
Transmitter Signal Timing 
Receiver Signal Timing 
Transmitter Signal Timing 
Transmitter Signal Timing 


























































































RS423/V.10/V.36 INTERFACE 


The physical connection of interchange circuits within a data terminal and a data set is made by a pair of 
pluggable connectors (the interface point.) The Chameleon side is a 37 pin Q-subminature socket (female) 
connector (DB37S). 

The terminal side consists of the matching male connector (DB37P). The pinout below is shown as the 
connector is viewed from the rear of the machine: 



Electrical Characteristics 

This is an unbalanced signal which has electrical characteristics which conform to CCITTs V. 10/E I A RS423. 


Driver Output voltage: 

± 

Output impedance: 

< 50 ohms 

Output current: 

1 50 mA maximum 

Receiver Input Voltage: 

± 10 volts 

Input impedance: 


Input sensitivity: 

± 200mvoits 
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DB37 Pin 
Number 


19 
37 

20 
28 
15 

12/30 
11 / 29 


ISO 

Circuit 


102 

102a 

102b 

~135 _ 

125 

108 

107 


4/22 

6/24 


103 

104 


17/35 

5/23 

8/26 


113 

114 

115 


7/25 


9/27 

106 

13/31 

109 

33 

110 

34 

136 

16 

111/126 

16 

111/126 

2 

112 


10 

14 

18 

"32" 

36 


141 
140 

142 
~U6 

117 


'36 CONI 


CCITT Circuit 
Mnemonic and Name 

Circuit 

Direction 

Circuit 

Type 

implem- 
ented by 
Chameleon 

SG 

Signai ground 

- 



X 

SC 

Send Common 

ToDCE 

Common 


X 

RC 

Receive Common 

From DCE 



X 

IS 

Terminal in Service 

ToDCE 




ic 

Incoming Cali 

From DCE 

Control 



TR 

Terminal Ready 

ToDCE 



X 

DM 

Data Mode 

From DCE 



X 

SD 

Send Data 

ToDCE 

Data 


X 

RD 

Receive Data . 

From DCE 



X 

TT 

Terminal Timing 

ToDCE 


1 

X 

ST 

Send Timing 

From DCE 

Timing 

M 

X 

RT 

Receive Timing 

From DCE 


A 

X 

RS 

Request to Send 

ToDCE 


R 

X 

CS 

Clear to Send 

From DCE 



X 

RR 

Receiver Ready 

From DCE 



X 

SQ 

Signal Quality 

From DCE 

Control 



NS 

New Signal 

ToDCE 




SF 

Select Frequency 

ToDCE 


N 


SR 

Signaling Rate Selector 

ToDCE 


N 


SI 

Signaling Rate Indicator 

From DCE 




LL 

Local Loopback 

ToDCE 




RL 

Remote Loopback 

ToDCE 

Control 



TM 

Test Mode 

From DCE 




SS 

Select Standby 

ToDCE 

Control 



SB 

Standby Indicator 

From DCE 
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RS422/V.11/V.36 INTERFACE 


The physical connection of interchange circuits within a data terminal and a data set is made by a pair of 
pluggable connectors (the interface point.) The Chameleon side is a 37 pin D-subminature socket (female) 
connector (DB37S). 

The terminal side consists of the matching male connector (DB37P). The pinout below is shown as the 
connector is viewed from the rear of the machine: 



Electrical Characteristics 


RS422 is a Balanced Voltage Digital Signal with electrical characteristics which conform to the CClTTs 
V.11/X.27. 


Driver Output resistance: 
Lead to ground: 
Output current: 
Output voltage: 
Receiver Input resistance: 
Lead to ground: 
Input sensitivity: 


200 ohms differential 
175 ohms 
150 mA maximum 
± 3 volts 

200 ohms differential 
175 ohms 
± 200 mvolts 
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DB37 Pin 
Number 

ISO 

Circuit 

CCITT Circuit 
Mnemonic and Name 

Circuit 

Direction 

Circuit 

Type 

19 

102 

SG 

Signal ground 

- 



37 

102a 

SC 

Send Common 

ToDCE 

Common 


20 

102b 

RC 

Receive Common 

From DCE 



28 

135 

IS 

Terminal in Service 

ToDCE 



15 

125 

1C 

Incoming Call 

From DCE 

Control 


12/30 

108 

TR 

Terminal Ready 

ToDCE 



11 / 29 

107 

DM 

Data Mode 

From DCE 



4/22 


SD 

Send Data 

ToDCE 

Data 

P 

6/24 


RD 

Receive Data 

From DCE 


R 

17/35 

mm 

TT 

Terminal Timing 

ToDCE 


1 

5/23 

n 

ST 

Send Timing 

From DCE 

Timing 


8/26 

WEM 

RT 

Receive Timing 

From DCE 


B 

7/25 

105 

RS 

Request to Send 

ToDCE 


R 

9/27 

106 

CS 

Clear to Send 

From DCE 


Y 

13/31 

109 

RR 

Receiver Ready 

From DCE 



33 

110 ' 

SQ 

Signal Quality 

From DCE 

Control 

H 

34 

136 

NS 

New Signal 

ToDCE 


A 

16 

111 / 126 

SF 

Select Frequency 

ToDCE 


N 

16 

111/126 

SR 

Signaling Rate Selector 

ToDCE 


N 

2 

112 

SI 

Signaling Rate Indicator 

From DCE 


E 

L 

10 

141 

LL 

Local Loopback 

ToDCE 



14 

140 

RL 

Remote Loopback 

To DCE 

Control 


18 

142 

TM 

Test Mode 

From DCE 



32 

116 

SS 

Select Standby 

ToDCE 

Control 


36 

117 

SB 

Standby Indicator 

From DCE 




Implem- 
ented by 
Chameleon 
- 

X 

X 

__ 

X 

X 

X 

- 

X 

- 

X 

X 

X 

X 

X 
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PARALLEL PRINTER CONNECTOR PINOUT 


The Chameleon parallel printer connector is a 25 pin D-sub socket (female) connector (DB25S). This 
connector is pinout and signal compatible with the IBM PC. It is also signal compatible with Centronics 
compatible parallel interface printers.The pinout is as shown below: 



All signals are standard TTL levels. 


Pin Number 

Description 

1 

/STROBE (Active Low) 

2 

DataO 

3 

Data 1 

4 

Data 2 

5 

Data 3 

6 

Data 4 

7 

Data 5 

8 

Data 6 

9 

Data 7 

10 

/ACK (Active Low) 

11 

Busy 

12 

No Connection 

13 

No Connection 

14 

No Connection 

15 

No Connection 

16 

No Connection 

17 

No Connection 

18 

Ground 

19 

Ground 

20 

Ground 

21 

Ground 

22 

Ground 

23 

Ground 

24 

No Connection 

25 

Ground 
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SERIAL PRINTER CONNECTOR PINOUT 


The Chameleon serial printer connector Is a 25 pin D-subminature socket (female) (DB25S). The pinout is 
shown as the connector is viewed from the rear of the machine: 



All signals are standard RS-232 voltage levels. The connector is physically and electrically a DCE type 
connector. 


DB25 

Pin 

No. 

CC1TT 

Circuit 

No. 

E1A 

Source 

Signal Name 



1 

— 

M 

Chassis 


Chassis Ground 

2 

103 

BA 

Printer 

TXD 

Transmit Data 

3 

104 

BB 

Chameleon 

RXD 

Receive Data 

4 

105 

CA 

Printer 

RTS 

Request to Send 

5 

106 

CB 

Chameleon 

CTS 

Clear to Send 

6 

107 

CC 

Chameleon 

DSR 

Data Set Ready 

7 

102 

AB 

Signal Gnd. 

GND 

Signal Ground 

8 

109 

CF 

Chameleon 

DCD 

Carrier Detect 

15 

114 

DB 

Chameleon 

TXC 

Transmit Clock 

17 

115 

DD 

Chameleon 

RXC 

Receive Clock 

20 

108 

CD 

Printer 

DTR 

Data Terminal Ready 

24 

- 

DA 

Printer 

CK 

External Clock 
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REMOTE I/O CONNECTOR PINOUT 


The Chameleon Remote I/O connector is a 25 pin D-subminature socket (female) (DB25S). The pinout is 
shown as the connector is viewed from the rear of the machine: 



All signals are standard RS232 voltage levels. The connector is physically and electrically a DCE type 
connector. 


1 


E!A 

Source 

Signal Name 



1 

101 

BOH 

Chassis 


Chassis Ground 

2 

103 

BA 

■ 1 

TXD 

Transmit Data 

3 


BB 

Chameleon 

RXD 

Receive Data 

n 

105 

CA 

Printer 

RTS 

Request to Send 

5 

106 

WEM 

Chameleon 

CTS 

Clear to Send 

6 

107 

cc 

Chameleon 

DSR 

Data Set Ready 

— 

102 

BOB 

Signal Gnd. 


Signal Ground 

8 

109 

CP 

Chameleon 

DCD 

Carrier Detect 

15 

114 

DB 

Chameleon 

TXC 

Transmit Clock 

191 

115 

DD 

Chameleon 

RXC 

Receive Clock 

20 

108 

CD 

Printer 

DTR 

Data Terminal Ready 

24 

_ 

EUR 

Printer 

CK 

External Clock 
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AUX 1 AND AUX 2 PORTS 
CONNECTOR PINOUTS 


The Chameleon Aux 1 and Aux 2 serial port connectors are 25 pin D-subminature sockets (female) (DB25S). 
The pinout for both is shown as the connector is viewed from the rear of the machine: 



All signals are standard RS232 voltage levels. The connector is physically and electrically a DCE type 
connector. 


DB25 

Pin 

No. 

CCITT 

Circuit 

No. 

E1A 

Source 

Signal Name 



1 


AA 

N/C 


Chassis Ground 

2 

103 


Terminal 

TXD 

Transmit Data 

3 

104 

BB 

Chameleon 

RXD 

Receive Data 

4 

105 

CA 

Terminal 

FITS 

Request to Send 

5 

106 

CB 

Chameleon 

CTS 

Clear to Send 

6 

107 

CC 

Chameleon 

DSR 

Date Set Ready 

u 

102 

AB 

Signal Gnd. 

GND 

Signal Ground 

15 

114 

DB 

Chameleon 

TXC 

Transmit Clock 

17 

115 

DD 

Chameleon 

RXC 

Receive Clock 

20 

108 

CD 

Terminal 

DTR 

Data Terminal Ready 

22 

125 

CE 

Terminal 

Rl 

Ring indicator 

24 

_ 

DA 

Terminal 

CK 

External Clock 
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VIDEO CONNECTOR PINOUT 


The Chameleon video connector is a 9 pin D-sub socket (female) connector (DB9S). The 
pinout is as shown below: 


\ CD <2> <D CD © ? 

\ <D CD CD <D - / 

Ail signals are standard TTL levels. 


Pin No. 

Description 

i 

Ground 

2 

Ground 

3 

Red 

4 

Green 

5 

Blue 

S 

Intensity 

7 

Monochrome 

8 

Horizontal Sync. 

9 

Vertical Sync. 


This connector is pinout and signal compatible with the IBM PC. The video signal requires a 
monitor capable of displaying 640 pixels by 240 lines (this is higher resolution than the 
standard PC CGA standard). High resolution or “Multisync” type monitors are 
recommended for use with the Chameleon. 
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SCSI INTERFACE SIGNALS 


The Chameleon SCSI interface signals are as shown below. Ail signals are low true. 



All odd pins are ground. 


GND 


GND 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 


Data Bit 0 (DBO). 
Data Bit 1 (DB1). 
Data Bit 2 (DB2). 
Data Bit 3 (DB3). 
Data Bit 4 (DB4). 
Data Bit 5 (DBS). 
Data Bit 6 (DBS). 
Data Bit 7 (DB7). 
Data Parity(DBP). 
Open. 

Open. 

Open. 

Open. 

Open. 

Open. 

Open. 

Open. 

Busy (BSY). 
Acknowledge (ACK). 
Reset (RST). 
Message (MSG). 
Select (SEL). 
Control/Data (C/D). 
Request (REQ)GND 
Input/Output (I/O) 
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DSCS INTERFACE 


The Digital Signal Customer Service (DSCS) interface has two receiver circuits and one transmitter circuit, 
enabling it to operate in either a Simulation or Monitoring mode. The figure below shows the DSCS interface 
module as viewed from the rear of the machine. 



The receiver (A) and transmitter (B) connections to the DSCS interface are industry-standard 3-conductor 
bantam jacks. The receivers operate with standard DSCS/DDS signals per AT&T Pub 62310 and Bellcore 
TA—TSY— 000083. The maximum distance from OCU and DSU is 1000 feet. 

The transmitter provides a balanced output. The pulse amplitude and shape is in accordance with AT&T Pub 
6231 0 and Bellcore TA-TSY-000083. The internal dock provides 56 KBPS 0.01%. This clock times the 
transmission when the Master/Slave switch is in the Master position. The pulse amplitude is 1 .66 volts 
nominal. The encoding/decoding method is AMI with zero suppression. 


SIMULATE 

MODE In SIMULATE mode, the DSCS uses one transmitter (B) and one receiver (A). In this mode, the 
interface provides the dock to the Chameleon; therefore, the Chameleon must be configured as a 
DTE The TERM/BRIDGE switch setting determines the input impedance, as follows: 

TERM Terminated. Provides a 1 35 ohm nominal input impedance 5 ohms, balanced 
BRIDGE Provides an input impedance greater than 3 K ohms, balanced 
The Master/Slave switch selects the transmitter clock used by the DSCS Interface, as follows: 
Master Transmits to the network using the intemaliy generated clock 

Slave Transmits to the network using the recovered received dock 


MONITOR 

MODE In MONITOR mode, the DSCS uses two receivers: the SIMULATE receiver (A) and the MONITOR 

receiver (A) . A TERM/BRiDGE switch is provided for each receiver. For both receivers, the DSCS 
Interface derives a dock from the received signal for use in received timing. 
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G.703 CO-DIRECTIONAL INTERFACE MODULE 


The CCITT G.703 Co-Directional Interface for the Chameleon 32 operates at 64 Kbps. It contains two 
receiver circuits and one transmitter circuit. This allows the interface to operate in either Simulation or 
Monitoring mode. The document used as a standard reference is the CCITT Red Book, Volume III - Fascicle 
111.3, Recommendation G.703. The figure below shows the Co-Directional Interface module as viewed from 
the rear of the machine. 



© © 

CO-DIRECTIONAL INTERFACE 




In simulate mode, the Co-Directional interfaces uses both the transmitter and receiver, in this mode, the 
Co-Directional interface module must be configured as a DTE. The Master/Slave switch selects the 
transmitter clock source used by the Co-Directional interface, as follows: 

*<£ When Master is selected, the transmit dock is generated by the internal dock of the Co-Directional 
interface. 

*<t When slave is selected, the transmit dock is derived from the recovered receive clock, and is thus syn- 
chronous to the receive dock. 

In Monitor mode, the Co-Directional interfaces uses two receivers: the Simulate receiver and the Monitor 
receiver. Both receivers use the received dock for receive timing. 

Each receiver is provided with a Term/Bridge switch. When Term is selected, the line is terminated with a 1 20 
ohm nominal input impedance. When Bridge is selected, the input impedance is greater than 3k ohms. If 
multiple receivers are connected to one line, only one should be terminated, and the remaining receivers set 
for Bridge mode. If only one receiver is connected, it should be in Term mode. 

Receivers Receivers operate with standard Co-Directional signals per CCITT Recommendation G.703. 

• Coding method: per G.703 

• Input Impedance: 

* 120 ohms 5 ohms, balanced {Term mode) 

* > 3k ohms, balanced (Bridge mode) 

• Bipolar signal input range 5.0 Volts peak-to-peak to 0.3 Volts peak-to-peak 


T ransmitter The transmitter provides a balanced output. 

• Output impedance: 120 ohms 5 ohms 

• Pulse amplitude and shape is in accordance with CCITT Rec. G.703. 

• Encoding method: per CCfTT Rec. G.703 
® Internal clock provides 64 KBPS 100 ppm. 

« Pulse amplitude: 1 .0 volts nominal, into 120 ohm balanced 

• Peak voltage of no pulse: 0 0.1 volts 
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X.21 INTERFACE INTERFACE MODULE 


The X.21 Interface is a combined hardware/software package that provides a physical interface for simulation 
and monitoring. The X.21 interface module is shown in the figure below. The X.21 interface conforms to the 
following CCITT recommendations: 

• CCITT recommendation X.21 1984 

• CCITT recommendation V. 11 1984 

• CCITT recommendation X.4 1980 



The 15 pin connector pin out is as follows: 


■BiOH 

Description 

i 

Shield 

2 

T(A) 

Transmit (A) 

3 

C(A) 

Control (A) 

4 

R(A) 

Receive (A) 

5 

mm 

Indication (A) 

6 

S(A) 

Signal Eement Timing (A) 

7 

B(A) 

Byte Timing (A) 

8 

Ground 

90 

T(B) 

Transmit (B) 

10 

C(B) 

Control (B) 

11 

R(B) 

Receive (B) 

12 

BM 

Indication (B) 

13 

S(B) 

Signal Eement Timing (B) 

14 

B(B) 

Byte Timing (B) 

15 

Reserved 


Refer to the Chameleon Protocol Interpretation Manual , Chapter 18, for a description of the X.21 software. 
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U-1NTERFACE I/O MODULE 


The ISDN PHYSICAL INTERFACE is a combined hardware/software package for 2B1 Q U-interface simula- 
tion and monitoring. Although designed to accommodate Basic Rate and Primary Rate, software is not pres- 
ently available for these implementations. A more complete description of this hardware is found in Chapter 
20: 2B1Q U-Interface of the Protocol Interpretation Manual. 



ISDN PHYSICAL INTERFACE 

HANDSET 

EXT 1 



IN 





1 


n 



DISCONNECT 
DEVICE FROM 
AC MAINS BEFORE 
REMOVING THIS 
MODULE 


LOCK 



TO NETWORK 


The exti and EXT2 connectors are 1 5-pin, D-subminiature females, oaiss type. The figures below give the 
pinouts for these bi-directional connectors. Ail signals are standard RS422 voltage levels. 

An RS449 cable is provided with the isdn 2B1 Q u-interface package. The chart below correlates the pins of 
this cable with those of the daiss connectors. 


DA15S 
Pin Number 

RS449 
Pin Number 

Description 

Direction 

1 

1 

Chassis Ground 


2 

22 

Send Data B 

Input 

3 

_ 

Unused 

— 

4 

24 

Receive Data B 


5 

— 

Unused 

— 

6 

23 

Send Timing B 

Output 

8 

19 

Signal Ground 

— 

9 

4 

Send Data A 

Inputs 

10 

— 

Unused 

— 

11 

6 

Receive Data A 

Output 

12 

— 

Unused 

— 

13 

5 

Send Timing A 

Output 

14 

_ 

Unused 

— 

15 

8 

Receive Timing A 

Output 
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